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CYCLE 11 HELPFUL HINTS 


THIS PAPER DESCRIBES HELPFUL HINTS ON HOW TO USE CYCLE 11 OF 
NOS/VE. IT IS INTENDED TO SUPPLEMENTs RATHER THAN TO REPLACEs 
THE STANDARD NOS/VE DOCUMENTATION. IF YOU HAVE ANY QUESTIONS OR 
SUGGESTIONSs PLEASE SEE TOM MCGEE OR BONNIE SWIERZBIN. APPENDIX 
A LISTS BACKGROUND DOCUMENTS AND HOW TO OBTAIN THEM. 


THE PROCEDURE TG PRINT COPIES OF THIS DOCUMENT HAS CHANGED FOR 
CYCLE 11. IT IS NOW POSSIBLE TO PRINT ANY SECTION(S) (OR 
SUBSECTIONS) AND TO SPECIFY A PREVIOUS LEVEL OF HINTS AGAINST 
WHICH REVISTON BARS ARE TO BE GENERATED. THE COMMAND USED TO 
OBTAIN EVULL COPIES OF THIS DOCUMENT WHILE RUNNING ON S/N 161 AT 
ARDEN HILLS IS STILL THE SAME 


SESsINTILISTHINTS C=<NUMBER OF COPIES> 


TO OBTAIN A COPY WITH REVISION BARS AGAINST THE HELPFUL HINTS 
OF A PREVIDUS BUILD» ONE CAN TYPE 


SESsINTI.sLISTHINTS REVB=<BUILD CYCLE NUMBER> C=<NUMBER OF 
COPIES> 


THE C PARAMETER IS OPTIGQNAL AND DEFAULTS TO ONE. ALLOWABLE 
VALUES FOR REVB ARE 5s 7s AND 9. 


TO OBTAIN A LISTING CF ONLY SELECTED SECTIONS» ONE SHOULEC 
ENTER 


SES sINTIeLISTHINTS SECTION=<LIST GF SECTION NUMBERS ENTERED 
AS STRINGS> 


FOR EXAMPLES SESsINTILISTHINTS SECTION=(91.0' 5 "4.601 23%) 
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UPDATE_HISTORY 
DATE 


12/22/80 
2/12/81 
6/09/81 
6/19/81 
8/28/81 
11/06/81 
3/01/82 
47/15/82 
5/01/82 
6/30/82 
74729782 
11/65/82 
11/29/82 
12/29/82 
1724783 


CHANGES 


REVISIONS FOR NOS/VE 
ADDITIONAL REVISIONS 
REVISIONS FOR NOS/VE 
ADDITIONAL REVISIONS 


REVISIONS 
REVISIONS 
REVISIONS 
REVISIONS 
REVISIONS 
REVISIONS 
REVISIONS 
REVISIONS 
REVISIONS 
REVISIONS 


FOR 
FOR 
FOR 
FOR 
FOR 
FOR 
FOR 
FOR 
FOR 
FOR 


NOS/VE 
NOS/VE 
NOS/VE 
NOS/VE 
NOS/VE 
NOS/VE 
NOS/VE 
NOS/VE 
NOS/VE 
NOS/VE 


ADDITIONAL REVISIONS 


PHASE 


2 
83/03/11 


Cc 


FOR NOS/VE PHASE C 


BUILD 


N 


FOR NOS/VE BUILD N 


BUILD | 


BUILD 


BUILD | 


CYCLE 
CYCLE 
CYCLE 
CYCLE 
CYCLE 
CYCLE 
CYCLE 


0 
P 
Q 
2 
3 
] 
7 
9 


10 
11 


FOR NOS/VE CYCLE 11 
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160 MAJOR CHARACTERISTICS OF THIS BUILD 


0 TWO SECTIONS HAVE BEEN ADDED TO THIS DOCUMENT: SECTION 1.1.6 
DESCRIBES THE DISPLAY_VARIABLE_LIST COMMAND AND SECTION 
2015215 DESCRIBES THE USE OF MESSAGE TEMPLATES. 


0 AS OF BUILD 11.135 THE 170 PART OF THE NOS/VE REMOTE HOST 
(IRHF170) WILL ROLLOUT FOR 15 SECONDS IF THERE ARE NO QUEUE 
FILES TO TRANSFER. ALSO ALL 170 PARTNER JOSS (GETF/REPF) WILL 
NOW BE STARTED BY THE NVE SUBSYSTEM JOB RATHER THAN THE 
IRHF170 JOB. STATISTICS FOR QUEUE FILES AND PARTNER JOBS CAN 
BE FOUND IN THE APPROPRIATE JO8"S DAYFILE. 


0 TERMINATION DUMPS -— AS OF CYCLE 9» NOS/VE HAS THE ABILITY TC 
PRODUCE AN EDD FORMAT DUMP WITHOUT TAKING NOS DOWNe THIS DUMP 
Is PRODUCED WHENEVER THE SYSTEM FAILS DUE TC A 
SOFTWARE JHARDWARE ERROR OR OPERATOR DROPVE COMMAND. 


WHEN THE SYSTEM FAILS» THE NVE CONTROL POINT WILL BRING UP 
A K=DISPLAY INDICATING THAT TERMINATION IS IN PROGRESS. THE 
APPROPRIATE RESPONSE IS Ke*RUN. A SHORT TIME AFTER THE *RUN 
IS ENTERED» A FLASHING TAPE REQUEST WILL BE SEEN ON THE NVE 
CONTROL POINT B<DISPLAY. AT THIS TIME A 9=TRACK TAPE SHOULD 
BE ASSIGNED TO THE NVE JO8- THE NVE JOB WILL PRODUCE AN EDD 
FORMAT DUMP ON THE TAPE (F#S»PE). FOLLOWING THE EDD DUMP WILL 
BE THE DUMPS AND DAYFILES OF THE [RHF AND PASSON JOBS. ANY 
FATAL ERRORS ENCOUNTERED WHILE WRITING THE TAPE WILL CAUSE THE 
CURRENT TAPE TO BE RETURNED AND ANOTHER REQUESTED. 


THE DUMP MAY BE DISPLAYED BY EITHER DSDI OR THE 160 
SIMULATOR (LEVEL 137 OR LATER). THE DUMP IS DIFFERENT FRCM A 
STANDARD EDD DUMP IN THAT ONLY NOS/VE MENORY AND PP'S ARE 
PRESENT ON THE DUMPs AND THE JPS VALUE DOES NOT CORRECTLY 
REFLECT THE FAILED NOS/VE ENVIRONMENT. NOS MEMORY IS NOT 
PRESENT ON THE DUMP. 


THIS TYPE OF DUMP IS SUFFICIENT FOR MOST NOS/VE FAILURES. 
IF A NOS PROBLEM IS SUSPECTED THE PROCESSOR SHOULD BE HALTED 
AND A STANDARD EDD DUMP PERFORMED. 


0 THE PROCEDURE FOR MIGRATING THE SYSTEM FROM LEVEL N TO LEVEL 
N+1 BY MEANS OF INSTALLING A NEW SET OF JOB TEMPLATES HAS BEEN 
IMPLEMENTED. THIS PROCEDURE IS DESCRIBED IN SECTION 5.3. 


O THE *"TM* FORMS CODE IS GONE. (SORRYs TOM.) THE DEFAULT FORMS 
CODE IS NQ FORMS CODE» WHICH MEANS 180 OUTPUT WILL PRINT ON 
ANY PRINTER WITH EC#A9 AND NO FORMS CODE ASSIGNED TO IT. 


O INPUT QUEUE FILES FOR BATCH JOBS GNLY AND OUTPUT QUEUE FILES 
ARE NOW RECOVERED AND RE-QUEUED. EXECUTING JOBS ARE NOT 
RECOVERED IN R1. . 


CYCLE lis JANUARY 1983 


1-2 


NOS/VE CYCLE 11 HELPFUL HINTS 


0 


83/C3/11 


THE VEDISPLAY CP {CONTROL POINT) HAS CHANGED TO VEDISPLAY AJ 
(ACTIVE JOBS). 


IN THE PAST» THE DS PROCEDUREs ALONG WITH THE FILES DOCFILEs 
RDCFILE» AND NVEPROL HAVE BEEN MAINTAINED BY THE 170 SCU = AND 
EXPANDED TO (PERMANENT) FILES BY THE EDITDS PROCEDURE. AS OF 
CYCLE 10 (USE1 AS OF 11/1/82) THESE FILES WILL BE DECKS ON 
VE1L7OPL AND WILL BE MAINTAINED VIA MADIFY MODSETS.» THE DECK 
NAMES ARE 


DDSPROC DS PROCEDURE - EVERYTHING IN ONE DECK 
DNVEPRL PROLOG FILE 
DCFILE DEADSTART COMMAND FILE 


1.1 NOSZVE_USAGE_EXAMPLES 
lelel EXECUTING PROGRAMS 


PROCESS 
CREATE AN OBJECT TEXT FILE BY COMPILING A PROGRAM ON NOS. 


THEN PERFORM THE FOLLOWING STEPS ON NOS/VE 


ACQUIRE ANY NECESSARY LIBRARIES (WHICH ARE NOT QUOTED IN TEXT 
EMBEDDED DIRECTIVES) BY EITHER 


D0 ATTACHING THEM FROM THE SYSTEM CATALOGs EITHER EXPLICITLY 


OR VIA PROLOG 
OR 


=O) «CREATING THE LIBRARY FILE VIA THE OBJECT LIBRARY GENERATOR 


OR 
Q STAGING THE LIBRARY FILE FROM NOS TO NOS/VE USING THE 
GET_OBJECT_LIBRARY COMMAND. 


GET THE FILE FROM NOS AND CONVERT THE OBJECT TEXT FILE FROM 
THE CI DATA MAPPING TO II DATA MAPPING BY EXECUTING THE 
CONVERTLOBJECTLFILE COMMAND. — i 


LOAD AND EXECUTE THE PROGRAM VIA THE EXECUTELTASK COMMAND» 
SPECIFYING THE NECESSARY LIBRARIES WITH THE LIBRARY PARAMETER} 
ALTERNATIVELY SET_PROGRAM_LATTRIBUTES MAY BE USED TO INCLUDE 
THE LIBRARIES IN ALL SUBSEQUENT EXECUTE_TASK COMMANDS. . 


STAGE THE LOADMAP FROM NOS/VE TO NOS FOR PRINTING BY USING 
EITHER 


QO THE REPLACELFILE COMMAND WITH AS CONVERSION MODE SPECIFIEC 
IF RUNNING ON THE SIMULATOR. 


OR 
0 THE PRINTLFILE COMMAND IF RUNNING ON THE HARDWARE. 
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EXAMPLES 


THE FOLLOWING IS AN EXAMPLE COMMAND SEQUENCE FOR EXECUTING A 
PROGRAM NOT REQUIRING ANY LIBRARIES FOR LOADING 


ASSUMPTIONS: ALL MODULES TO BE LOADED ARE CONTAINED ON THE NOS 
PERMANENT FILE *CITXTRS*. 


CONVERTLOBJECTLFILE CITXTRS 
EXECUTE_TASK CITXTRS PARAMETER=*PROGRAM PARAMETERS? 
PRINT _FILE LOADMAP 


THE FOLLOWING IS AN EXAMPLE COMMAND SEQUENCE FOR EXECUTING A 
PROGRAM REQUIRING LIBRARIES FOR LOADING 


ASSUMPTIONS: THE NOS PERMANENT FILE "CITXTRS* CONTAINS OBJECT 
TEXT GENERATED BY THE CYBIL CI COMPILER. THE COMPILER MODULES 
REFERENCE PROCEDURES CONTAINED ON THE LIBRARY "MYLIB*® AND THE 
CYBIL RUN-TIME LIBRARY. THESE LIBRARIES HAVE BEEN GENERATED ON 
NOS/VE AND SAVED ON NOS. | 


GETLOBJECTLLIBRARY MYLIB 

SET_ PROGRAM_LATTRIBUTES LOADUMAP. ~OPTIONS=(BLOCKs ENTRY_ POINT sSEGMENT) 
CONVERT_ OBJECT_ FILE CITXTRS | 

EXECUTE_TASK CITXTRS "PROGRAM PARAMETERS!’ LIBRARY=MYLIB 

PRINT_FILE LOADMAP 


1.1.2 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT ON NOS 


NOTES. 


0 CLGO170 IS NOS PERMANENT FILE NAME FOR FILE CONTAINING CI 
OBJECT TEXT FOR MODULES TO BE INCLUDED IN THE LIBRARY. 


O IITEXT180 IS NOS/VE LOCAL FILE NAME FOR FILE CONTAINING II 
OBJECT TEXT FOR MODULES TO BE INCLUDED IN THE LIBRARY. 


O LIBRARY18O0 IS NOS/VE LOCAL FILE NAME FOR THE LIBRARY BEING 
CREATED. 


O ILIB170 IS NOS PERMANENT FILE NAME FOR FILE CONTAINING THE 
LIBRARY. 


NOS/VE JO8 COMMANCS 


CONVERT_LOBJECTLFILE TITEXTI80 CLGO170 
CREATE_LOBJECT LIBRARY 

ADDIMODULE LIBRARY=TITEXT180 

GENERATE _LIBRARY LIBRARY=LIBRARY1 890 
QuIT 
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REPLACE_LFILE LIBRARY180 ILIB170 DC=B56 
lele3 MODIFY A PREVIQUSLY SAVED OBJECT LIBRARY 
NOTES. 
GO ILIB1I70 IS NOS PERMANENT FILE NAME FOR FILE CONTAINING THE OLD 
LIBRARY 


O LIBRARY180 IS NOS/VE LOCAL FILE NAME FOR FILE CONTAINING THE 
DOLD LIBRARY 


0 (C€MO0D170 IS NOS PERMANENT FILE NAME FOR FILE CONTAINING CI 
OBJECT TEXT FOR THE NEW MODULE 


GO NEWIIMODULE IS NOS/VE LOCAL FILE NAME FOR FILE CONTAINING II 
OBJECT TEXT FOR THE NEW MODULE 


O NEWLIBRARY IS NOS/VE LOCAL FILE NAME FOR THE LIBRARY BEING 
CREATED 


O NLIB1L70 I5 NOS LOCAL FILE NAME FOR NEW LIBRARY 
NOS/VE J08 COMMANDS 


GETLOBJECTLLIBRARY LIBRARY180 IL1I8170 
CONVERTLOBJECTLFILE NEWIIMODULE CMOD1L76 
CREATELOBJECT_LIBRARY | 

ADD_MODULE LIBRARY=LIBRARY180 
REPLACE_MODULE LIBRARY*NEWIIMODULE 
GENERATE_LIBRARY LIBRARY=NEWLIBRARY 
QuIT 

REPLACE FILE NEWLIBRARY NLIB170 DC=856 


1e1.4 ROUTE AN INPUT FILE FROM NOS TO NOS/VE 


RUNNING FROM AN INTERACTIVE TERMINAL, ENTER 


GETsFILENAME. 
ROUTE» FILENAME» OC=LPsFC=RH. 


THE INPUT FILE WHICH IS SENT TO NOS/VE MUST BE IN 6/12 ASCII 
(OR DISPLAY CODE SUBSET). THE JOB FILE MUST BE <A SINGLE 
PARTITION NOS RECORD CONTAINING NOS/VE COMMANDS. THE FIRST 
STATEMENT MUST BE A VALID LOGIN COMMAND WITH USER» PASSWORD AND 
FAMILY NAME SPECIFIED. MULTI PARTITION INPUT FILES ARE NOT 
SUPPORTED 8Y NOS/VE SO NOS DATA FILES USED 8Y THE PROGRAM MUST BE 
OBTAINED THROUGH THE GETLFILE COMMAND. 
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141.5 PRINT A NOS/VE FILE 


AT NOS/VE JOB TERMINATION THE JOB LOG WILL BE AUTOMATICALLY 
RETURNED TO NOS. THE JOB LOG WILL BE APPENDED TO THE NOS/VE 
DUTPUT FILE OUTPUT. NOS/VE PRINT FILES MUST BE WRITTEN BY BAM AS 
8/8 ASCII RT=V. PRINT FILES WILL BE CONVERTED FROM 8/8 ASCII 
RT=V TO NOS 8712 ASCII WHEN THEY ARE SENT TO NOS AND WILL BE 
PRINTED IN UPPER/LOWER CASE. 


ALL NOS/VE OUTPUT FILES WILL APPEAR IN THE NOS OUTPUT CUEUE 
(NOS QsPR DISPLAY) WITH THE NAME NVEXXXX AS A BANNER, IN ORDER 
TO PRINT A NOS/VE FILEs THE FOLLOWING COMMAND MUST BE ISSUED 
WITHIN YOUR JOB OR BE ENTERED FROM THE SYSTEM CONSOLE VIA THE 
OPERATOR FACILITY 


PRINTLFILE FILENAME 
leleS MESSAGE TEMPLATES ON NOS/VE 


TO MAKE FULL USE OF THE FACILITIES OF THE NOS/VE SYSTEM 
MESSAGE GENERATOR» A PRODUCT OR USER PROGRAM MUST MAKE AVAILABLE 
A MESSAGE TEMPLATE MODULE. MESSAGE TEMPLATE MODULES ARE PRODUCED 
VIA THE UTILITY GENMT (AN SES PROCEDURE IN NOS/VE INTEGRATION'S 
PROCEDURE LIBRARY)» AND THEN COMPILED WITH CYBIL. 


THE MESSAGE TEMPLATE MODULE FOR A PRODUCT OR USER PROGRAM WILL 
TYPICALLY EXIST IN TwO PLACES 


- ON ONE OF THE OBJECT FILES OR LIBRARIES THAT COMPRISE THE 
PRODUCT OR USER PROGRAM (THIS MAKES MESSAGE TEMPLATES 
BELONGING TG THE PRODUCT OR USER PROGRAM AVAILABLE WHILE IT 
IS “ACTIVE") 


- ON AN OBJECT LIBRARY IN THE COMMAND LIST (THIS MAKES 
MESSAGE TEMPLATES BELONGING TO THE PRODUCT GR USER PROGRAM 
AVAILABLE WHEN IT IS NOT "ACTIVE"). 


WHEN THE MESSAGE FORMATTER NEEDS A TEMPLATE IT SEARCHES THE - 
FOLLOWING 


- SYSTEM: THESE ARE THE TEMPLATES FOR THE OPERATING SYSTEM 
AND CERTAIN PRODUCTS. THEY ARE “BUILT-N" AND ALWAYS 
AVAILABLE. 


- PROGRAM: THESE ARE THE TEMPLATES FOR THE CURRENTLY ACTIVE 
(RUNNING) PRODUCT OR USER PROGRAM. THEY ARE ACCESSED VIA 
THE DYNAMIC LOAD INTERFACE (PMPSLOAD). 


- COMMAND LIST: THESE ARE THE TEMPLATES FOR ALL PRODUCTS. 
EACH OBJECT LIBRARY IN THE COMMAND LIST IS SEARCHED AND IF 
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THE TEMPLATE IS FOUND IT IS ACCESSED VIA AN INTERNAL FORMS 
OF THE OYNAMIC LOAD INTERFACE (PMPSLOAD_FROM_LIBRARY). 
PRODUCT SET MESSAGE TEMPLATES RESIDE ON THE LIBRARY THAT IS 
PART GF THE SSYSTEM COMMAND LIST ENTRY. TEMPLATES FOR USER 
PROGRAMS MAY RESIDE ON ANY OTHER LIBRARY IN THE COMMAND 
LIST. 


SINCE THE LOADER IS USED TO ACCESS NON-SYSTEM TEMPLATES IT I$ 
NOT POSSIBLE TO CHANGE A TEMPLATE (ACTUALLY A RANGE OF TEMPLATES) 
IN A TASK ONCE IT HAS (THEY HAVE) BEEN LOADED. THIS SHOULD CNLY 
IMPACT DEVELOPERS OF PROCUCTS OR PROGRAMS TRYING TO CHECK OUT NEW 
MESSAGES. 
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200 COMMAND INTERFACE STATUS 


201 ACCESS _IO_NOSZVE_IN_DUAL_SIAIE 
Zelel LOGIN TO NOS/VE 


IT IS NO LONGER NECESSARY TO FORCE THE FIRST LOGIN ATTEMPT TO 
FAIL. TO ACCESS VEIAF RESPOND AS FOLLOWS TOC THE “FAMILY:" 
PROMPT 


sUSER»s PASSWORD» VETAF 


YOU CAN ACCESS VEIAF FROM IAF BY DOING “HELLO»sVEIAF™ OR BY 
ANSWERING VEIAF TO THE SYSTEM PROMPT “APPLICATION: *. 


2ele2 TERMINAL USAGE 


1) THE SLANT (/) IS THE PROMPT TO ENTER A NOS/VE COMMAND. ANY 
NORMAL NOS/VE COMMAND CAN NOW BE ENTERED (CONTINUATION 
LINES ARE PRCMPTED WITH ecf/)-e THE FULL ASCII CHARACTER 
SET» LOWER OR UPPER CASE AND ALi SPECIAL CHARACTERS» CAN BE 
USED. : 


2) A LOGOUT COMMAND WILL CAUSE THE NOS/VE INTERACTIVE JCB TO 
TERMINATE. A NEW NOS/VE INTERACTIVE JOB (CAN THEN BE 
STARTED BY RESPONDING TO THE "APPLICATIONS PROMPT WITH 
VETAF. 


3) TERMINAL BREAKS (CONTROL-T AND CONTROL=P) CAN BE USED TO 
TERMINATE A TASK OR COMMAND AND SUSPEND A TASK AND ENTER A 
NEW TASK TO PROCESS SCL COMMANDS. CONTROL-T CAUSES A 
TERMINATE BREAK AND CONTROL=P CAUSES A PAUSE BREAK. 
TERMINATE BREAK WILL TERMINATE A COMMAND OR THE MOST 
RECENTLY EXECUTED TASK. A PAUSE BREAK WILL SUSPEND 
EXECUTION AND ALLOW COMMANDS TO BE ENTERED. WHEN A 
TERMINAL IS IN PAUSE BREAK STATEs TWO ADDITIONAL COMMANDS 
ARE AVAILABLE 


RESUME_COMMAND - RESUME EXECUTION AT THE POINT OF 
INTERRUPTION, 


TERMINATE COMMAND = CAUSE A TERMINATE BREAK CONDITION AS IF 


A TERMINATE BREAK HAD BEEN ENTERED~ 


BOTH TERMINATE BREAK AND PAUSE BREAK ARE AVATLAB8LE TO PROGRAMS 
AS CONDITIONS VIA THE PROGRAM MANAGEMENT CONDITION MECHANISM. 
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2e1e3 NOS/VE PROGRAM ACCESS TQ THE TERMINAL 


1) INTERACTIVE NOS/VE JOBS ARE ABLE TO OBTAIN TERMINAL INPUT 
THROUGH THE AMPSGETLNEXT OR AMPSGET_LPARTIAL PRCGRAM 
INTERFACE WHICH CAN BE USED BY BOTH TASK SERVICES AND USER 
RING PROGRAMS. INTERACTIVE PROGRAMS WHICH USE THIS 
INTERFACE SHOULD BE ABLE TO HANDLE BOTH UPPER AND LOWER 
CASE INPUT IN ORDER TO MAKE THEM MORE CONVENIENT TO USE IN 
BOTH 64 AND 96 CHARACTER SET MODES. 


2.2 COMMAND. AND. PARAMETER NAMES 


DURING THE NEXT FEW MONTHS A COMMAND SUPPORTED BY THE SYSTEM 
MAY NOT BE IN SYNC WITH YOUR COMMAND INTERFACE DOCUMENT. THE 
PARAMETER DESCRIPTOR TABLE GIVES AN ACCURATEs CONCISE DESCRIPTION 
OF THE COMMAND INTERFACE AS CURRENTLY SUPPORTED. 


POT_READER SS GUIDE 


THE DEFINITION OF A COMMAND'S PARAMETER LIST IS ENCLOSED IN 
PARENTHESIS WITH A PARAMETER DESCRIPTION PER LINE. EACH 
DESCRIPTION HAS THE GENERAL FORM 


PARAMETER NAMES ALLOWED PARAMETER VALUES = PARAMETER DEFAULT 
VALUE 


PARAMETER NAMES =- DESCRIBES THE PARAMETER NAME AND ANY 
ABBREVIATIONS. 


ALLOWED PARAMETER VALUES = DESCRIBES THE KIND OF VALUE ALLOWED 
AND WHETHER A LIST OF VALUES IS POSSIBLE. THE VALUE KIND CAN BE 
FURTHER QUALIFIED. IN SOME CASES» THE ACTUAL VALUES ALLOWED ARE 
DESCRIBED USING THE KEY NOTATION. THE VALUE KINDS INCLUDE 
INTEGERs STRING» NAMEs FILE» STATUS. 


PARAMETER DEFAULT VALUES =- DESCRIBES THE DEFAULTING RULES 
AND/OR VALUES FOR THE PARAMETER. SREQUIRED AND $0PTIGNAL ARE 
OBVIOUS. OTHER VALUES IN THIS POSITION WILL BE TREATED AS IF 
THEY WERE ENTERED BY THE USER ON COMMAND INVOCATION. 


SEE THE PROC COMMAND IN THE COMMAND INTERFACE ERS FOR MORE 
DETAILS. 


THE POTS FOR THE COMMANDS CURRENTLY IN THE SYSTEM CAN BE 
DISPLAYED USING THE DISPLAY _COMMAND_LINFORMATION COMMAND. THIS IS 
DOCUMENTED IN THE NONSTANDARD COMMAND SECTION OF THIS DOCUMENT. 
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COMMAND FUNCTIONS 


EUNCTION 


$MOD 

$CHAR 
$CLOCK 
$DATE 
SFILE 

$ FNAME 
SINTEGER 
$NAME 

$ORD 

SREAL 
$STRING 
SSTRLEN 
SSTRREP 
SSUBSTR 
SUNTQUE 
$TIME 

SVAR 
$SPECIFIED 
$SET_COUNT 
$VAL UE_COUNT 
SRANGE 
SPARAMETER LIST 
$PARAMETER 
$STATUS 
$CON OITION 
$SEVERTITY 
$PROCESSOR 
$ JOB 


SPROGRAM 


$RING 


SYSTEM_ ACCESS COMMANDS 


COMMANDS 


SETLLINKLATTRIBUTES 
LOGIN 

LOGOUT 

SETI PASSWORD 


SIAIUS 


UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 
UNC HANGED 
UNC HAN GEO 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
NEW 


sTAtus 


UNCHANGED 
UNCHANGED 


- UNCHANGED 


UNC HANGED 


2-3 
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- *i) 


THE FAMILY NAME OF THE JOB DOING THE SUBMIT WILL BE USED AS 
THE DEFAULT FAMILY NAME ON BATCH JOBS. THE 
SUBMITTED FROM NOS WILL BE FAMILY $SSYSTEM. 


MEANS THAT WHENEVER NOS/VE 
FAMILY PARAMETER IS REQUIRED. 


JO8S ARE 


DEFAULT FOR JOBS 


THIS EFFECTIVELY 
SUBMITTED FROM NOS THE 
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CYCLE 11 HELPFUL HINTS 
RESOURCE MANAGEMENT 


COMMAND 
REQUEST_TERMINAL 
EILE_ MANAGEMENT 


COMMAND 


SETLFILE_LATTRIBUTES 
COPY_FILE 

DISPLAY_FILE - 
COMPARE_FILE 
DISPLAY_FILE_LATTRIBUTES 
SKIP _TAPE | 


PERMANENT_EILE_ MANAGEMENT 
COMMAND 


GET_LFILE 

REPLACE_FILE 
CREATE_LFILE 
ATTACH_LFILE 
DELETE_FILE 
CHANGE_CATALOG_ENTRY 
CREATE _FILE_PERMIT 
DELETE_FILE_ PERMIT 
CREATE _CATALOG 
DELETE_CATALOG 
DELETE_CATALOG_PERMIT 
CREATE_PERMIT_CATALOG 
DISPLAY_CATALOG 
DISPLAY_CATALOG_ENTRY 
SET_ WORKING CATALOG 


COMMAND 


PROC/PROCEND 
SET_COMMAND_LIST 
DISPLAY COMMAND LIST 
REPEAT/UNTIL 
WHILE/WHILEND 
CREATE _ VARIABLE 
DELETE_VARIABLE 

BLOC K/BLOCKEND 
LOOP/LOOPEND 

FOR/ FGOREND 
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STAIUs 
UNCHANGED 


STAIUS 


UNCHANGED 


UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 


aTAIUs 


UNCHANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 


STarus 


UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
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IF/ELSETF/ELSE/IFEND 
CYCLE 

EXIT 

WHEN JWHENEND 

CONTINUE 

CANCEL 

INCLUDE FILE 
COLLECTLTEXT 
DISPLAY_VALUE 
EXITLPROC 

ACCEPT _LINE 

INCLUDE LINE 
CREATE_FILE_CONNECTICN 
DELETE_FILE_ CONNECTION 
DISPLAYLFILE_CONNEC TION 
CHANGE HCS VARIABLE 
DISPLAY HCS VARIABLE 


INTERACTIVE COMMANDS 


COMMAND 


RESUME COMMAND 
TERMINATE COMMAND 
SETLTERMINAL_ATTRIBUTES 


DISPLAY _TERMINAL_ATTRIBUTES 


ESC-E 
ESC-t 
ESC-J 
ESC-T 
ESC=-X 


THESE COMMANDS ARE 
ESCAPE_KEY>» 
THE FOLLOWING MEANINGS 


xia mm 


COMMAND 


CREATE _OBJECT_LIBRARY 
DISPLAY_NEW_LIBRARY 
SELECT_DISPLAY_OPTION 
ADD_MODULE © 
REPLACE_MODULE 

COMB INE_MODULE 


ENTERED 
CHARACTERs CARRIAGE_RETURN. 


UNC 
UNC 
UNC 
UNC 
UNC 
UNC 
UNC 
UNC 
UNC 
UNC 
UNC 
UNC 
UNC 
UNC 
UNC 
UNC 
UNC 


aIA 


UNC 
UNC 
UNC 
UNC 
NEW 
NEW 
NEW 
NEW 
NEW 


UNC 
UNC 
UNC 
UNC 
UNC 
UNC 
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HANGED 
HANGED 
HANGED 
HANGED 
HANGED 
HAN GED 
HANGED 
HANGED 
HANGED 
HANGED. 
HANGED 
HANGED 
HANGED 
HANGED 
HANGED 
HANGED 
HANGED 


Tus 


HANGED 
HANGED 
HANGED 
HANGED 
- 1* 


- 1* 


THE 3~KEY SEQUENCE 


THE CHARACTERS EAVE 


PERFORM "DISPLAY_JOBLSTATUS™ COMMAND 
PERFORM “DISPLAY_LOG 10" COMMAND 

PERFORM “DISPLAY_JOBLSTATUS ALL™ COMMAND 
DISCARD ALL UNPROCESSEDs 
TERMINATE JOB» BUT DO NOT DISCONNECT 


2.10 QBILECT CODE MAINTENANCE 


TYPED~AHEAD INPUT 


sTarus 


HANGED 
HANGED 
HANGED 
HANGED 
HANGED 
HANGED 
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CREATE_ MODULE UNC HANGED 
BIND MODULE UNCHANGED 
CREATE_ PROGRAM _DESCRIPTION UNCHANGED 
DELETE MODULE UNCHANGED 
CHANGE _MOOULE_ATTRIBUTE UNCHANGED 
SATISFY_LEXTERNAL_REFERENCES UNCHANGED 
REORDER MODULE UNCHANGED 
GENERATE LIBRARY UNCHANGED 
DISPLAY_OBJECT_LIBRARY UNCHANGED 
COMPARE _OBJECT_LIBRARY UNCHANGED 
QUIT UNC HANGED 
CI TO tI CONVERSION UNCHANGED 
2e1l USER SERVICES 
COMMAND aTarus 
DISPLAY _LOG UNCHANGED 
DISPLAY MESSAGE UNCHANGED 
EILE_SOUTING 
COMMAND © slats 
HCS JMROUTE REMOVED 
2013 J03_MANAGEMENT 
COMMAND STATUS 
SUBMIT. JOB UNCHANGED 
DISPLAY JOBLSTATUS UNCHANGED 
TERM INATE_J08 UNCHANGED 
PRINTLFILE UNCHANGED 
TERMINATE PRINT UNC HANGED 
DISPLAY_PRINT_STATUS UNCHANGED 
201% JOB _ MANAGEMENT 
COMMAND aTAIus 
SUBMIT_ JOB UNCHANGED 
DISPLAY _JOBLSTATUS UNCHANGED 
TERMINATE JOB UNCHANGED 
PRINTLFILE UNC HANGED 
TERMINATE_PRINT UNCHANGED 
DISPLAY PRINT_STATUS UNC HANGED 


2015 NON_STANDARO COMMANDS 


THE FOLLOWING COMMANDS PROVIDE A NGNSTANDARD MEANS OF 
PERFORMING VARIOUS FREQUENTLY PERFORMED FUNCTIONS.» THEY MAY BE 
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SUPERCEDED IN SUBSEQUENT BUILDS BY STANDARD COMMANDS AND 
CAPABILITIES. 


2015.1 DELETELCATALOG CONTENTS 1 DELCC 


THE PURPOSE OF THIS COMMAND ITS TO DELETE ALL ENTRIES FROM THE 
SPECIFIED CATALOG. THIS INCLUDES SUBCATALOGS AND THE FILES THEY 
CONTAIN. 


DELETE_CATALOG_CONTENTS CCATALOG=<CATALOG>] 
CSTATUS2<STATUS VARIABLED] 


CATALOGICs: THIS PARAMETER SPECIFIES FROM WHICH CATALOE ALL 
FILES ARE TO BE DELETED. OMISSION WILL CAUSE 
THE CURRENT WORKING CATALOG TO BE USED. 


STATUS: SEE ERROR HANDLING. 
201562 DISPLAY_LACTIVE_TASK 1 DISAT 


THE PURPOSE OF THIS COMMAND IS TO DISPLAY TASK STATISTICS FOR 
ALL CURRENTLY ACTIVE TASKS IN A J08. THE FOLLOWING INFORMATION 
IS DISPLAYED. 


TASK NAME 
EXECUTION TIME USE 
NUMBER OF PAGE FAULTS 


DISPLAY_LACTIVE TASK COUTPUT=<FILE>] 
CSTATUS=<STATUS VARIABLED] 


OUTPUT10: THIS PARAMETER SPECIFIES THE FILE TO WHICH THE 
TASK STATISTICS IS DISPLAYED. OMISSION WILL 
CAUSE SOUTPUT TO BE USED. 


201523 DISPLAY_SYSTEM_DOATA 1 DISSD 


THE PURPOSE OF THIS COMMAND IS TO DISPLAY SYSTEM PAGE FAULT 
STATISTICS AND SYSTEM MONITOR REQUEST STATISTICS. 


DISPLAY_SYSTEM_DATA CDOISPLAY_OPTION#=PAGE_FAULTS1PF 
LMONT TOR LREQUESTSIMRIALL 
COI SPLAY_FORMAT=INCREMENTALII1TOTALIT] 
COUTPUT=<FILE>] 
CSTATUS*<STATUS VARIABLED] 


DISPLAY_OPTIONIDO: THIS PARAMETER SPECIFIES WHICH 


STATISTICS ARE TO BE DISPLAYED. THE 
FOLLOWING OPTIONS ARE ALLOWED 
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DISPLAYLFORMATIDF? 


DUTPUT1O8 


STATUS: 


2-8 
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PAGE_FAULTS - DISPLAY THE PAGE 
FAULT STATISTICS. 


‘ 


MONI TOR_REQUESTS DISPLAY THE SYSTEM 


MONITOR REQUEST 

STATISTICS.» | 

OMISSION WEILL CAUSE ALL TO BE 
| USED. 


THIS PARAMETER SPECIFIES WHETHER A 
DISPLAY OF THE ALL STATISTICS RECCRDED 
SO FAR (TOTAL) OR ONLY THOSE STATISTICS 
RECORDED SINCE THE LAST 
DISPLAYLUSYSTEM_DATA COMMAND 
(INCREMENTAL) SHOULD BE DISPLAYED. 
OMISSION WILL CAUSE INCREMENTAL TC BE 
USED. 


THIS PARAMETER SPECIFIES THE FILE TC 
WHICH THE SYSTEM DATA WILL BE DISPLAYED. 
OMISSION WILL CAUSE SOUTPUT TO BE USED. 


SEE ERROR HANDLING. 


221544 DISPLAY _JOB_DATA 1 DISJD 


THE PURPOSE OF THIS COMMAND IS TO DISPLAY THE FOLLOWING J08 


RELATED STATISTICS 


TIME IN JOB MODE 
TIME IN MONITOR MODE 
COUNT OF PAGE IN OPERATIONS 


RECLAIMED PAGES 


NEW PAGES ASSIGNED 
WORKING SET SIZE 
COUNT OF READY TASKS 


DISPLAY_JOB_DATA CDISPLAY_OPTION=JOB_LDATAJ 
CDISPLAY. FORMAT =INCREMENTALII1TOTALITI 
COUTPUT=<FILE>] 
CSTATUSS<STATUS VARTABLED] 


DISPLAY_OPTIONI0DO3 


THIS PARAMETER SPECIFIES WHICH 

STATISTICS ARE TO BE DISPLAYED. THE 

FOLLOWING OPTIONS ARE ALLOWED 

JOB_DATA — DISPLAY JOB RELATED DATA. 

OMISSION WILL CAUSE JOB_DATA TC BE 
USED. 
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DISPLAY_FORMATIDF: THIS PARAMETER SPECIFIES WHETHER A 
DISPLAY OF THE ALL STATISTICS RECCRDED 
SO FAR (TOTAL) GR ONLY THOSE STATISTICS 
RECORDED SINCE THE LAST DISPLAY_JOB_OATA 
COMMAND C INCREMENTAL) SHOULD BE 
DISPLAYED. OMISSION WILL CAUSE 
INCREMENTAL TO BE USED. 


OQUTPUTID: THIS PARAMETER SPECIFIES THE FILE TO 
WHICH THE JOB DATA WILL BE DISPLAYED. 
OMISSION WILL CAUSE $OUTPUT TO BE USED. 


STATUS: SEE ERROR HANDLING. 
2215.5 DISPLAY_COMMAND_INFORMATION 1 DISCI 


THE PURPOSE OF THIS COMMAND IS TO DISPLAY CURRENT INFORMATION 
ABOUT A NOS/VE COMMAND. THE PARAMETER NAMES» ABBREVIATIONS» 
ALLOWED VALUES AND KNOWN PROBLEMS FOR A COMMANDs AS SUPPORTED IN 
THE CURRENT SYSTEM» CAN BE DETERMINED. THIS IS A NONSTANDARD 
COMMAND AND WILL BE REPLACED BY THE HELP UTILITY SOMETIME IN THE 
FUTURE. 


DISPLAY_COMMAND_LINFORMATION COMMAND _NAME=<NAMEDIALL 
CUTILITY_NAME=CREATE_OBJECT_ULIBRARY1 
COLISOURCE_CODE_UTILITYISCUISYSTEM) 
CDISPLAY_OPTION=PARAMETER_ DESCRIPTION TABLE 
PDOTINOTESINAMESIHELP] 
COUTPUT=<FILE REFERENCED] 
CSTATUS*<STATUS VARIABLED] 


COMMAND_NAMELCN? THIS PARAMETER SPECIFIES THE NAME OF THE 
COMMAND ABOUT WHICH INFORMATION IS TO BE 
DISPLAYED. 


UTILITY_NAMELUN? THIS PARAMETER SPECIFIES WHICH UTILITY 
THE COMMAND BELONGS TO. OMISSION WILL 
CAUSE SYSTEM TO BE USED. 


DISPLAY_OPTIONIDO: THIS PARAMETER SPECIFIES THE TYPE OF 
DISPLAY BEING REQUESTED. THE OPTIONS ARE 


PARAMETER DESCRIPTION_TABLEIPOT - SELECTS 
A DISPLAY OF THE PARAMETER DESCRIP- 
TION TABLE USED BY THE COMMAND WHEN 
EXECUTED. 


NOTES = SELECTS A DISPLAY OF ANY KNOWN 
PROBLEMS WITH THE COMMAND. 


NAMES - SELECTS A DISPLAY OF THE COMMAND 
NAMES FOR A UTILITY. 
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HELP = SELECTS A DISPLAY OF THE COMMAND 
INTERFACE DESCRIPTION OF THE COMMAND. 


OMISSION WILL CAUSE PDT TO BE USED. 


QUTPUTID3 THIS PARAMETER SPECIFIES THE FILE TO 
WHICH INFORMATION WILL BE DISPLAYED. 
OMISSION WILL CAUSE SOUTPUT TO BE USED. 


STATUS: SEE ERROR HANDLING. 
2.15.6 CONVERT_OBJECT_FILE 1 CONDF 


THE PURPOSE OF THIS COMMAND IS TO GET A NOS/VE OBJECT FILE 
PRODUCED ON NOS AND TO CONVERT IT TO AN OBJECT FILE SUITABLE FOR 
PROCESSING BY THE NOS/VE LOADER OR QBJECT CODE MAINTENANCE 
COMMANDS. 


CONVERTLOBJECTLFILE TO=<FILE REFERENCED 
CFROM=<NAME>] 
CUS ER=<NAME> J 
CSTATUS=<STATUS VARIABLED] 


TO1LTs THIS PARAMETER SPECIFIES THE NOS/VE FILE NAME CN 
WHICH THE CONVERTED OBJECT FILE IS TO BE WRITTEN. 


FROMIFS THIS PARAMETER SPECIFIES THE NAME OF THE NOS FILE TO 
BE CONVERTED. THIS IS THE PERMANENT FILE NAME AS 
DEFINED IN THE NOS FILE SYSTEM AND CAN BE UP TO SEVEN 
CHARACTERS IN LENGTH. 


OMISSION WILL CAUSE THE PERMANENT FILE NAME OF THE 
TO PARAMETER TO BE USED. 


USERLU: THIS PARAMETER SPECIFIES THE NOS USER IDENTIFICATION 
NF THE OWNER OF THE FILE. THIS PARAMETER IS ONLY 
NECCESSARY IF THE FILE IS IN A CATALOG OTHER THAN THE 
USER WHO WAS SPECIFIED BY THE MOST RECENTLY ISSUED 
SETLLINK ATTRIBUTES COMMAND. 


STATUS: SEE ERROR HANDLING. 
2.15.7 GETLOBJECTLFILE 1 GETOF 

THE PURPOSE OF THIS COMMAND IS TO GET A PREVIOUSLY CONVERTED 
NOS/VE OBJECT FILE FROM THE NOS SIDE AND SETS THE APPROPRIATE 
FILE ATTRIBUTES THAT WILL ALLOW THE OBJECT FILE TO BE USED BY 
NOS/VE. | 
GETLNBJECTLFILE TO=<FILE REFERENCED 
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FROMLF: 


USER1Us 


STATUS! 
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CF ROM=<NAME>] 
CUSER=<NAMED>] 
CSTATUS=<STATUS VARIABLED] 


THIS PARAMETER SPECIFIES THE NOS/VE FILE NAME OF THE 
OBJECT FILE. 


THIS PARAMETER SPECIFIES THE NOS FILE NAME OF THE 
OBJECT FILE. THIS IS THE PERMANENT FILE NAME AS 
DEFINED IN NOS AND CAN BE UP TO SEVEN CHARACTERS IN 
LENGTH. 


OMISSION WILL CAUSE THE PERMANENT FILE NAME OF THE 
TO PARAMETER TO BE USED. 


THIS PARAMETER SPECIFIES THE NOS USER IDENTIFICATION 
OF THE OWNER OF THE FILE. THIS PARAMETER IS ONLY 
NECESSARY IF THE FILE IS IN A CATALGG OTHER THAN THE 
USER WHO WAS SPECIFIED BY THE MOST RECENTLY ISSUED 
SET_LLINK_ATTRIBUTES COMMAND. 


SEE ERROR HANDLING. 


2015.8 GETLOBJECT LIBRARY 1 GETOL 


THE PURPOSE OF THIS COMMAND IS TO GET A PREVIOUSLY CREATED 
NOS/VE OBJECT LIBRARY FROM THE NOS SIDE AND SET THE APPROPRIATE 
FILE ATTRIBUTES THAT WILL ALLOW THE OBJECT LIBRARY TO BE USED ON 


NOS/VE. 


GETLOBJECTLLIBRARY TOs<FILE REFERENCED 


Tout: 


FROMLF8 


USERLUs 


C FROM=<NAME> J 
LUSER=<NAME>] 
CSTATUS®<STATUS VARTIABLED] 


THIS PARAMETER SPECIFIES THE NOS/VE FILE NAME OF THE 
OBJECT LIBRARY. 


THIS PARAMETER SPECIFIES THE NOS FILE NAME OF THE 
OBJECT FILE. THIS IS THE PERMANENT FILE NAME AS 
DEFINED IN NOS AND CAN BE UP TO SEVEN CHARACTERS IN 
LENGTH. 


OMISSION WILL CAUSE THE PERMANENT FILE NAME OF THE 
TO PARAMETER TO BE USED. 


THIS PARAMETER SPECIFIES THE NOS USER IDENTIFICATION 
OF THE OWNER OF THE FILE. THIS PARAMETER IS ONLY 
NECESSARY IF THE FILE IS IN A CATALOG OTHER THAN THE 
USER WHO WAS SPECIFIED ON THE MOST RECENTLY ISSUEC 
SETLLINKLATTRIBUTES COMMAND, 
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STATUS: SEE ERROR HANDLING. 
2.15.9 DISPLAY_LOBJECTLTEXT 1 DISOT 


THE PURPOSE OF THIS COMMAND IS TO PRODUCE A FORMATTED DISPLAY 
OF THE OBJECT TEXT CONTAINED IN AN OBJECT FILE OR OBJECT LIBRARY 
PRODUCED ON NOS/VE. 


DISPLAY_OBJECTLTEXT FILE=<FILE> 
COUTPUT=<FILE REFERENCED] 
CSTATUS=<STATUS VARTIABLED] 


FILELF: THIS PARAMETER SPECIFIES THE OBJECT FILE OR OBJECT 
LIBRARY CONTAINING THE OBJECT TEXT TO BE LISTED. 


OQUTPUT1LO3 THIS PARAMETER SPECIFIES THE FILE TO WHICH THE 
DISPLAY IS TO BE WRITTEN. 


OMISSION WILL CAUSE THE FILE $OUTPUT TO BE USED. 
STATUS! SEE ERROR HANDLING. 
2215.10 GET_LSOURCE_LIBRARY 1 GETSL 


THE PURPOSE OF THIS COMMAND IS TO GET A PREVIOUSLY CREATED SCU 
SOURCE LIBRARY FROM THE NOS SIDE AND SET THE APPROPRIATE FILE 
ATTRIBUTES THAT WILL ALLOW THE SOURCE LIBRARY TO BE USED ON 
NOS/VE. 


GETLSOURCE_LIBRARY TO*<FILE REFERENCED 
CFROM=<NAMED] 
CUSER=<NAME>] 
CSTATUS*<STATUS VARTABLED] 


TOLT: THIS PARAMETER SPECIFIES THE NOS/VE FILE NAME OF THE 
SOURCE LIBRARY. 


FROMLF! THIS PARAMETER SPECIFIES THE NOS FILE NAME OF THE 
SOURCE LIBRARY. THIS IS THE PERMANENT FILE NAME AS 
DEFINED IN NOS AND CAN BE UP TO SEVEN CHARACTERS IN 
LENGTH. 


OMISSION WILL CAUSE THE PERMANENT FILE NAME OF THE 
TO PARAMETER TO BE USED. 


USER1Ut THIS PARAMETER SPECIFIES THE NOS USER IDENTIFICATION 
OF THE OWNER OF THE FILE.’ THIS PARAMETER IS ONLY 
NECESSARY IF THE FILE IS IN A CATALOG CTHER THAN’ THE 
USER WHO WAS SPECIFIED ON THE MOST RECENTLY ISSUED 
SETLLINK_LATTRIBUTES COMMAND, 
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2215.11 EDITLFILE 1 EDIF 
THE PURPOSE OF EDITLFILE IS TO INITIATE THE EXECUTION OF THE 
SCU EDITOR ON A TEXT FILE. (FOR DETAILS SEE ARH3883.) 


EDITLFILE 1 EDIF = EDIT LINES ON A SOURCE FILE. (PROCEDURE FILE 
NOT NECESSARILY IN ITS FINAL FORM) 


PARAMETERS DEEAULTS 
FILE=FILE (SOURCE) SREQUIRED 
CRESULT=F ILE (SOURCE) SVALUE (FILE) 
CINPUT=FILE REFERENCE ] $COMMAND 
COUTPUT=FILE REFERENCE) $OUTPUT 
CSTATUS] 


2015.12 JEDIT 


THE PURPOSE OF THIS COMMAND IS TO INITIATE EXECUTION OF THE 
JEDIT EDITOR BUILT BY JACK BOHNHOFF. ANYONE WANTING INFORMATION 
ABIDUT THE EDITOR SHOULD CONTACT JACK. 


JEDIT FROM=<FILE> 
CSTATUS*<STATUS VARIABLE>] 


FROMIF% THIS PARAMETER SPECIFIES THE FILE T0 BE EDITED. 
THIS FILE IS REWRITTEN AFTER THE EDITOR TERMINATES. 


STATUS? %SEE ERROR HANDLING IN THE NOS/VE COMMAND 
INTERFACE. 


2215.13 DEBUG 


THE PROTOTYPE R1 NOS/VE DEBUGGER IS NOW AVAILABLE. DETAILS ON 
HOW TO USE THE DEBUGGER CAN BE FOUND IN THE "CYBER 180 
INTERACTIVE DEBUG EXTERNAL REFERENCE SPECIFICATION AND USER'®S 
GUIDE™s SUNNYVALE DCS NUMBER S4028,. 


2015014 SET_LINKLATTRIBUTES 1 SETLA 


THE SETLLINKLATTRIBUTES COMMAND IS THE SAME AS DOCUMENTED IN 
THE NOS/VE COMMAND INTERFACE WITH THE EXCEPTION THAT THE CHARGE 
AND PROJECT PARAMETERS ARE OPTIONAL (AND IN FACT NOT USEFUL IN 
THE CURRENT ENVIRONMENT SINCE WE DISABLE THAT FEATURE ON THE NOS 
SIDE). 
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2015.15 DISPLAY_VARIABLE_LIST 1 DISVL 


THE PURPOSE OF THIS CCMMAND IS TO DISPLAY ALL LOCAL VARIABLES. 
DISPLAY_VARIABLE_LIST COUTPUT=<FILE REFERENCE>] 
CSTATUS=<STATUS VARIABLE>] 
DUTPUT10: THIS PARAMETER SPECIFIES THE FILE TO WHICH THE 
INFORMATION WILL BE DISPLAYED. 
OMISSION WILL CAUSE $OUTPUT TO BE USED. 
STATUS! SEE ERROR HANDLING. 
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300 PROGRAM _INTEREACE STATUS 


UNCHANGED FROM THE PREVIOUS 
BUILD OR NOT AVAILABLE IN THIS 
WITHIN EACH SECTION. 


361 


302 


3.3 


COMMAND. PROCESSING 
PROCEDURE 


CLPSSCAN_PARAM_LIST 
CLPSTEST_LPARAMETER 
CLPSGETLUKEYWORD 
CLPSGET_SET_COUNT 
CLPSGET_VALUE_ COUNT 
CLPSTES TLRANGE 
CLPSGET_VALUE 

CLPSCREATE_ VARIABLE 
CLPSDELETE_VARIABLE 
CLPSREAD_VARIABLE 
CLPSWRITE_L VARIABLE 
CLPSSCAN_COMMAND_FILE 
CLPSEND_LSCAN_LCOMMAND_FILE 
CLPSSCAN_COMMAND LINE 
CLPSCREATE_FILE_ CONNECTION 
CLPSDELETE_FILE_ CONNECTION 
CLPSPUSH/POP_LUTILITY 
CLPSGET_COMMAND_ORI GIN 
CLPSGET_DATA_LINE 
CLPSSCAN_PROC_ DECLARATION 


MEL AGE GENERATOR 
PROCEQURE 
OSP$FORMAT_MESSAGE 
OSPSSET_STATUS_ABNORMAL 
OSPSAPPEND_STATUS_PARAMETER 
OS PS APPEND_STATUS_INTEGER 
RESOURCE MANAGEMENT 
PROCEQURE 


RMPSREQUEST_MASS_ST ORAGE 
RMPSREQUEST_LTERMINAL 


ALL TERMINAL ATTRIBUTES CAN 


THE "STATUS" COLUMN INDICATES WHETHER THE 


aTarus 


UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNC HANGED 


SIAIUS 


UNC HAN GED 
UNCHANGED 
UNCHANGED 
UNCHANGED 


aTarus 


UNCHANGED 
UNCHANGED 


SPECIFIED ON THE 
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PROCEDURE IS 
BUILD» MODIFIED FROM THE PREVIOUS 


FOOTNOTES NUMBERED 


RMPSREQUESTLTERMINAL CALL BUT ONLY THE FOLLOWING ARE OPERATIONAL 
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304 


3e 5 


0 AYUTOLINPUT 

D TRANSPARENT_MODE 
0 PROMPT_LFILE 

QO PROMPT_LSTRING 
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FILES ASSIGNED TO A TERMINAL DEVICE CAN BE ACCESSED VIA THE 
FOLLOWING BAM REQUESTS 


AMPSOPEN 
AMPSGET_NEXT 
AMPSGET_DIRECT 
AMPSGET_PARTIAL 
AMPSPUT_NEXT 
AMPSPUT_DIRECT 
AMPSPUT_PARTIAL 
AMPSCLOSE 
AMPSREWIND 
AMPSSKIP 
AMPSSEEK_DIRECT 


PROGRAM_EXECUTION 
PROCEDURE 


PMPSEXIT 

PMPSEXECUTE 

PMPS TERMINATE 
PMPSAWATIT_ TASK TERMINATION 
PMPSMODULE _TABLE_ADDRESS 
PMPSENTRY_POINT_TABLE_ADDRESS 
PMPSPUSH_T ASK_DE BUG_ MODE 
PMPSSETLTASK_DEBUG_ MODE 
PMPSTASK_ DEBUG _MODE_ON 
PMPSSET_DEBUG_RING 
PMPSDEBUG_RING 

PMP SCHANGE_ DEBUG _LIBRARY_LIST 
PMPS$POP_TASK_DEBUG_ MODE 


PROGRAM COMMUNICATION 
PROC EQURE 


OSPSAWAIT_LACTIVITY_COMPLETION 
PMPSDEFINE_ QUEUE 

PMPSREMOVE QUEUE 

PMPSCONNEC T_QUEUE 

PMP SDISCONNECT QUEUE 

PMPSSEND TO_LQUEUE 
PMPSRECEIVE.FROM_QUEUE . 
PMPSSTATUS _ QUEUE 
PMPSSTATUS_QUEUES_DEFINED 
PMPSGETLQUEUE_LIMITS 


aTaTus 


UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 


STAIus 


UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 
UNCHANGED 
UNC HANGED 
YNCHANGED 
UNC HANGED 
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327 


329 
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CONDITION. PROCESSING 
PROCEDURE 
PMPSESTABL ISH CONDITION HANDLER 


PMPSDISESTABLISH COND HANDLER 
PMPSCAUSE_CONDITION 
PMPSCONTINUE_TO_CAUSE 
PMPSTESTUCONDITION_ HANDLER 
PMPSVALIDATE_PREVIOUS_SAVE_AREA 
PMPSESTABLISH DEBUG OFF 
OSPSSET_USTATUS_FROM_CONDITION 


PROGRAM_ SERVICES 
PROCEDURE 


PMP SGENERATE_UNI QUE_NAME 
PMPSGET_TIME 
PMPSGET_MICROSECOND_CLOCK 
PMPSGETUTASK_CPUTIME 
PMPSGET_DATE 
PMPSGETLUSER_IDENTIFICATON 
PMPSGET_ACCOUNT_ PROJECT 
PMPSGET_JOBLNAMES 
PMPSGET_JOB_LID 
PMPSGET_JOB_MODE 

PMPS$GE T_PROGRAM 
PMPSGET_LTASK_ID 
PMPSMANAGE_SENSE_SWITCHES 
PMPSGET_LOS_VERSION 

PMPSGET _ PROCESSOR_LATIRIS UTES 
PMPSDEF INE DEBUG ENTRY 
PMPS$GET_DE BUG_ENTRY 
PMPS$MODIFY_DEBUG_ENTRY 
PMPSREMOVE_DEBUG_ ENTRY 


LOGGING 
PROCEDURE 


PMPSLOG 
PMPSLOG_LASCII 


EILE_MANAGEMENT 
PROCEDURE 

SEQUENTIAL ACCESS 
BYTE_ADDRESSABLE ACCESS 


RECORD ACCESS 
SEGMENT ACCESS 


aTarIus 


ADDED SUPPORT OF DETECTED 
UNCORRECTED ERROR 


UNC HANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 


aTatus 


UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNC HANG ED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 
UNCHANGED 


slTalus 


UNCHANGED 
UNC HANGED 


aTaqus 


UNCHANGED 
UNCHANGED 
UNCHANGED 


UNCHANGED = ¥*1 
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V_SYSTEM SPECIFIED UNC HANGED 
V_LUSER SPECIFIED UNCHANGED 
U_SYSTEM SPECIFIED UNCHANGED 
U_LUSER SPECIFIED UNCHANGED 
F_SYSTEM SPECIFIED UNCHANGED 
FLUSER SPECIFIED UNCHANGED 
AMPSDESCRIBE_NEW_FILE DELETED 
AMPSFILE UNCHANGED 
AMPSGET_FILE_ATTRIBUTES UNCHANGED 
AMPSFETCH UNCHANGED 
AMPSSTORE UNCHANGED 
AMP$COPY_FILE UNCHANGED 
AMPSRENAME UNCHANGED 
AMPSRETURN_FILE NEW NAME 
AMPSOPEN UNCHANGED 
AMPSCLOSE UNC HANGED 
AMPSFETCH_ACCESS_INFORMATION UNCHANGED 
AMPSSKIP UNCHANGED 
AMPSREWIND *2 
AMPSWRITE_END_ PARTITION UNCHANGED 
AMP$GET_NEXT UNC HAN GED 
AMP S$GET_DIRECT UNCHANGED 
AMPSGET_PARTIAL UNCHANGED 
AMPS PUT_NE XT UNCHANGED 
AMPSPUT_DIRECT UNCHANGED 
AMPSPUT_PARTIAL UNCHANGED = *3 
AMPSSEEK_DIRECT UNCHANGED 
_ AMPSGET_SEGMENT_ POINTER UNCHANGED 
AMPSSET_SEGMENT_EOI UNCHANGED 
AMPSSET_SEGMENT_ POSITION UNCHANGED 
AMPSSET_LOCAL_NAME_ ABNORMAL UNCHANGED 
AMPSSET_FILE_INSTANCE_ABNORMAL UNC HANGED 
AMPSACCESS_METHOD UNCHANGED 
AMPSFETCH_FAP_POINTER UNCHANGED 
AMPSSTORE_FAP_POINTER UNCHANGED 
*1 SEGMENT ACCESS IF A SEGMENT ACCESS FILE IS WRITTEN AND AN 


*2 


*3 


AMPSSET_SEGMENT_LEQI IS NOT 
REMAINS ZERO. 
THE DEFAULT EOI. 


ISSUED TO 


RECORD THE EQIs EQI 
THE HIGHEST PAGE REFERENCED IS NOT YET USED AS 
THIS PARTICULARLY AFFECTS THOSE WHO WISH TO 


MAKE HEAPS PERMANENT BECAUSE EQI IS ALWAYS ZERO FOR A HEAP. 


AMPSREWIND THE WAIT PARAMETER ON THE 
SUPPORTED. 


PROCEDURE CALL IS NOT 


AMPSPUT_PARTIAL PUT_PARTIAL WITH THE TERM_OPTION = 
AMCSTERMINATE DOES NOT ACT AS A PUTLNEXT IF A PRECEDING START 
WAS NOT ISSUED. 
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PROCEDURE 

PFPS DEFINE 
PFPSATTACH 

PFPS PURGE 
PFPSCHANGE 
PFPS$PERMIT 

PFPSDEL ETE_PERMIT 
PFPSDEFINE CATALOG 
PFP$PURGE_CATALOG 
PFPSPERMIT_CATALGG 
PFPSDELETE_CATALOG_PERMIT 


3e11 MEMORY MANAGEMENT 


MMPSADVISE_IN 

MMPSADVISE_OUT 
MMPSADVISE_OUT_IN 
MMPSWRITE_MODIFIED_PAGES 
MMPSCREATE_SEGMENT 
MMPSDELETE_SEGMENT 
MMPSSTORE_SEGMENT_ATTRIBUTES 
MMPS FETCH SEGMENT_ATTRIBUTES 
MMPSVERTIFY_ACCESS 

MMPSFREE 

MMPSLOCK_ PAGES 

MMPSUNLOCK PAGES 

MMPSFETCH PVA_LUNWRITTEN_ PAGES 


3e12 STATISTICS FAcILIry 


SFPSESTABLISH STATISTIC 
SFPSENABLE_STATISTIC 
SFPSDIS ABLE_STATISTIC 
SFPSDISESTABLISH STATISTIC 
SFPSEMITLSTATISTIC 
SFPSEMITLSYSTEM_STATISTIC 


3013 INTERACTIVE FACILITY 


IFPSTERMINAL 
IFPSFETCH_ TERMINAL 
IFPSSTORE_ TERMINAL 


IFPSGET_DEFLT_TERMINAL_ATTRIBUTES 


IFPSGET TERMINAL _ATTRIBUTES 
IFPSADVANCE 


STATUS 

UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 


UNCHANGED 
UNCHANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 
UNCHANGED 


3-5 


€3/€3/11 


NUMBER OF LOCKED PAGES PER 
SEGMENT RESTRICTED TO 32 


UNCHANGED 


UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 
UNCHANGED 


UNCHANGED 
UNCHANGED 
UNC HANGED 
UNCHANGED 
UNC HANGED 
NEW - ¥*1 


*1 ONLY THE OPTION ITFCSADVANCE_ALL_QUEVED_OUTPUT IS SUPPORTED. 


CYCLE lls JANUARY 1983 


3-6 


NOS/VE CYCLE 11 HELPFUL HINTS 
83/03/11 


3014 NOSAVE_EXCEPTIONS 


THE FOLLOWING SUMMARIZES THE EXCEPTION CODE RANGES CURRENTLY 
ASSIGNED TO NOS/VE. THESE CODE RANGES REPRESENT A FINER 
BREAKDOWN THAN THE ONE SPECIFIED IN THE SIS FOR INTERNAL NOS/VE 
DEVELOPMENT PURPOSES.» HOWEVER» IT IS IMPORTANT TO REMEMBER THAT 
ONLY THE PRODUCT IDENTIFIERS DOCUMENTED IN THE SIS MAY APPEAR IN 
ERROR MESSAGES. 


COMMON MODULES 7 95000 - 95999 
COMMON CODE GENERATOR 85000 - 89999 
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PRODUCT 

EXCEPTION CODE IDENTIFIER PRODUCT NAME 

1 = 1585999 RESERVED 
159000 = 1593999 SY SYSTEM CORE 
1603000 = 1693999 AM BASIC ACCESS METHODS 

1605000 = 1635999 BA BASIC ACCESS 

1642000 - 164999 LN LOCAL NAME MGR 

165,000 - 1655999 JF JOB FILE MGR 

166000 - 1663999 SR CONVERSION SERVICES 
1703900 - 1793999 CL COMMAND LANGUAGE 
1809000 - 1895999 JM JOB MANAGEMENT 
190,000 = 1995999 LL LOADER 
200%000 — 209,999 MM MEMORY MANAGEMENT 

200%000 = 2043999 NM MONITOR LEVEL 

2052000 = 2055999 MM TASK LEVEL 
2105000 = 2195999 os OPERATING SYSTEM 

2105000 = 2105999 os oS 

211,000 - 2115999 MT EXEC 

2125600 - 2122999 10 MS I/D 

2132000 - 2135999 10 TAPE I/0 

2142000 = 2145999 DM DEVICE MANAGEMENT 

215000 = 2155999 ML MEMORY LINK 

2163000 - 2165999 IF INTERACTIVE 

2172000 - 2175999 ™ TM MONITOR 

2182000 - 2185999 ™ T™ TASK 

2192000 — 219999 JS JCB SWAPPERS 
2202000 - 229,999 PF PERMANENT FILE 

MANAGEMENT 

2212000 = 2215999 ST SET MANAGEMENT 

2229000 - 2229999 PU PERMANENT FILE UTILITIES 
2302000 - 2395999 PM PROGRAM MANAGEMENT 
2405000 - 2495999 RM RESOURCE MANAGEMENT 
256000 - 259999 OF OPERATOR FACILITY 
2609000 - 2695999 AV USER ADMINISTRATOR 
2702000 — 2799999 IC INTERSTATE COMMUNICATION 
2802000 = 2893999 RH REMOTE HOST FACILITY 
2902000 = 2999999 oc OBJECT CODE UTILITIES 
3003000 - 3097999 DS DEADSTART/RECOVERY 
310,000 - 319,999 MS MAINTENANCE SERVICES 
320s000 - 3295999 IF INTERACTIVE FACILITY 
330,000 - 3395999 US USER ERRORS 
3402000 - 3495999 SF STATISTICS FAC. 
3502000 — 3595999 cM CONFIGURATION MANAGEMENT 
3602000 — 3699999 HU HELP UTILITIES 
370000 - 379999 NA NETWORK ACCESS METHOD 
5002000 - 5093999 AA ADVANCED ACCESS METHOD 
5102000 - 5193999 AG ALGOL 
5202000 = 529999 AL ASSEMBLY LANGUAGE 
530.000 - 5395999 AP APL 
540,000 ~- 549,999 BA BASIC 
550:000 - 559999 CA CONVERSION AIDS SYSTEM 
560s000 - 5695999 CB COBOL 
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390s 000 
600s 000 
610,000 
6202000 
649,099 
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5793 999 
5893999 
5993999 
6095999 
6199999 
6293999 
6499999 


cY 
FT 
PA 
Pl 
SM 
$C 
DB 
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CYBIL 

FORTRAN 

PASCAL (WIRTH) 

PL/1 

SORT MERGE 

SOURCE CODE UTILITY 
DEBUG 


CYCLE lis JANUARY 1983 


4-1 
NOS/VE CYCLE 11 HELPFUL HINTS 
: 83/03/11 


4.0 QUAL STATE. DEADSTART_AND_OPERATION 
401 CURRENT DUAL STATE _CONELGURATLION 


THE ARDEN HILLS S2 DEVELOPMENT LAB CONTAINS 12 FMD UNITS. 
GO FMD UNIT 43 (CH. 1s 215 22) 
THIS UNIT CONTAINS NOS PERMANENT FILES~ 


O FMD UNTT 41 (CH. Is 215 22) 
THIS UNIT CONTAINS THE FOLLOWING 
- FILES REQUIRED TO DEADSTART DUAL STATE CYCLE 11.13 A17C NOS 
(601 PLUS CHANGES NECESSARY FOR CYCLE 11.1)» CTI» MSL» EI 
BINARIES» AND NOS DEADSTART FILES~ 
- IT IS ALSO USED AS A TEMP DEVICE. 
GO FMD UNIT 42 (CH. 1» 21s 22) 


THIS UNIT CONTAINS NOS PERMANENT FILES. 


0 FMD UNIT 44 (CH. 1) 
THIS IS ANOTHER NOS PF DEVICE. 
O FMD UNIT 45 (CHe 1) 


THIS UNIT CONTAINS FILES REQUIRED TO DEADSTART DUAL STATE 
CYCLE 11462 AND LATER$ NOS 5641 DEADSTART FILEs CTIs MSL» AND 
EI.s IT IS ALSO A NOS TEMP DEVICE. 


THE FOLLOWING DEVICES ARE AVAILABLE FOR HANDS-ON USES CHANNEL 
ls 21s 223 UNIT 403 CHANNEL 25 225 31: UNITS 44 AND 453 CHANNEL 
2: UNITS 409 4159 429 AND 43. 


402 USER_NAMES AND PERMANENT _EILES 


1) THE CONVENTION USED FOR CREATING USER NAMES ON NOS/VE IS = AS 
FOLLOWS 
O YOUR USER NAME WILL BE YOUR INITIALSs 
9 YOUR PASSWORD WILL BE THESE 3 LETTERS FOLLOWED BY THE 
LETTER *X*, | 
9 YOU MUST SEE COMSOURCE (RK. COOPER =- X3092) TO BE 
ASSIGNED A USER INDEX 


2) PF DUMPING AND LOADING 
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YOU MAY USE "“SES.DUMPPFY ON SN/101 TO DUMP YOUR PERMANENT 
FILES TO TAPEs AND THEN LOAD THEM ONTO YOUR USER NAME ON A170 
NOS USING "SESeLOADPF™. DOCUMENTATION ON HOW TO USE THESE SES 
PROCEDURES AND WHAT THEIR PARAMETERS ARE IS INCLUDED IN THE 
SES USER*®S GUIDEs OR THEY CAN BE OBTAINED BY TYPING 


SES»HELP .DUMPPF AND SES»HELP.LOADPF. 
403 CONVERTING VERSION.1_ VALIDATION FILES _TO_ VERSION 2 


THE BASIC REFERENCE FOR THIS SECTION IS THE NOS V2 SYSTEM 
MAINTENANCE MANUAL (60459300)s SECTION 5¢ THE BEST SPECIFIC 
REFERENCE IS EXAMPLE 13 ON PAGE 5-37 IN THAT MANUAL, 


USING NOS 52359 THE ANALYST SHOULD DO THE FOLLOWING 


XeDIS. 

SUIs377777. 

PURGE (STJURCE/NA) 
DEFINE(S QURCE) 
MODVAL(OP=S 5S=SOURCE »FA) 
DROP. ~ 


NEXTs THE FILE SOURCE SHOULD BE XEDITED WITH THE FOLLOWING 
DIRECTIVES 


D/AB e222 /* 
DINF eo oe=/* 

D/DF ...2/* 
C/STANDARD/NORMAL/ * 
C/CMLIJCNVE /* 


FINALLY» AFTER BRINGING UP A NOS V2 SYSTEMs DO THE FOLLOWING 
(NOTES AN IDLE FAMILY SITUATION MUST EXIST WHEN THE ISF COMMANDS 
ARE GIVEN.) 


XeDISe 

SUIs377777. 

PURGE sNEWDUZsNEWNDZ. 

DEFINEsNEWDUZsNEWNDZ. 

ATTAC Hs SOURCE. 

MODV ALC OP2C » T@SOURCE sSI sN=NEWDU Zs U*NEWNDZ) 

RE TURN(NEWDUZsNEWNDZ) 

ISFsR=NEWDUZ. (WILL RELEASE NEWDUZ ITF IT IS FAST-ATTACH) 
ISFs E=NEWDUZ. 

DROP. 
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404 TO_RELQAD CONTROLWARE FOR THE NOS/VE_DISK DRIVER 


AT DEADSTART TIME NOS WILL AUTOMATICALLY LOAD 7155-1X DISK 
CONTROLWARE ON ONE CHANNEL WITH CONTROLLER TYPE=FM (LBC CMRDECK 
ENTRY)» AND WILL AUTOMATICALLY LOAD 7155=-4X DISK CONTROLWARE ON 
ANY CHANNEL WITH CONTROLLER TYPE=HT (LBC CMRDECK ENTRY). NOS/VE 
SUPPORTS BOTH OF THOSE TYPES OF CONTROLLERS. NOTE: IT IS NOT 
POSSIBLE TO USE 844 HALF-TRACK CONTROLWARE IN THIS ENVIRONMENT. 


405 AlZ7Q_NOS_DEADSTART 
4o5.1 CTI AND CHECKING CENTRAL MEMORY 


DEADSTARTING A17G NOS ASSUMES SOME KNOWLEDGE OF CTI. CTI 
STANDS FOR COMMON TEST AND INITIALIZATION. IT IS SOFTWARE THAT 
PLACES AN 800 SERIES MACHINE IN A STATE SUCH THAT IT IS POSSIBLE 
TO OEADSTART AN OQOPERATING SYSTEM. CTI £5 USED SOMEWHAT 
AMBIGUOQUSLY IN THE SOFTWARE COMMUNITY TO IMPLY CTI AND MSL 
(MAINTENANCE SOFTWARE LIBRARY). THE MSL IS A COLLECTION OF 
PROGRAMS AND DATA THAT INCLUDES SUCH THINGS AS A SUBSET QF CMSE 
(CYBER MAINTENANCE SOFTWARE EXECUTIVE) THAT ENABLES ONE TO LOAD 
CONT ROLW ARE TO CONTROLLERS» LOOK AT CYBER 186 MAINTENANCE 
REGISTERS» LOOK AT MICROCODEs éTC. THE MSL ALSO CONTAINS 
MICROCODE THAT CAN BE LOADED BY CTI. THE MSL IS ACTUALLY AN 
OPERATING SYSTEM THAT RUNS INDEPENDENTLY OF NOS. AN IMPORTANT 
ELEMENT OF CTI/MSL IS HIVS (HARDWARE VERIFICATION SEQUENCE )> 
WHICH IS A PROGRAM THAT LOADS MICROCODEs CLEARS AND CHECKS 
CENTRAL MEMORY AND TESTS ALL 170 OPCODES.» IF YOU ARE NOT SURE 
WHAT THE MACHINE WAS USED FOR (PARTICULARLY THE FIRST HANDS ON 
USER EACH MORNING) THEN THE HIVS PROGRAM SHOULD BE RUN. THIS I$ 
ACCOMPLISHED BY 


1) DEADSTART TO NOS/VE (UNIT 40 FOR S35 UNIT 45 FOR S2) 
2) ENTER O (OPERATOR INTERVENTION) 
3) ENTER P (DEADSTART PANEL »MAKE SURE LEVEL 0 DEADSTART) 
4) <BKSP> 
5) ENTER H (ASSURE YOURSELF THAT CS=YES TO RELOAD MICROCODE) 
6) <BKS P> 
7) ENTER V (VERIFICATION SEQUENCE) 
8) HIT <CR> AT "PARAMETER DISPLAY’ TO TEST CM & CP 
WHEN YOU SEE TEXT THAT TELLS YOU THAT VERIFICATION IS COMPLETE 
AND A ODEADSTART IS REQUIREDs YOU ARE NOW READY TO DEADSTART NOS. 


CYCLE 11» JANUARY 1983 


| 4-4 
NOS/VE CYCLE 11 HELPFUL HINTS 
83/03/11 


40.522 NOS DEADSTART 


0 SET THE O/S PANEL TO DEADSTART FROM THE PRIMARY SYSTEM fDISK. 
THIS IS UNIT 41 FOR 11.21 AND UNIT 45 FOR 11.2 AND SUBSEQUENT 
SYSTEMS. 

PUSH D/7S BUTTON 

ENTER (CR) 

ENTER DATE/TIME 


WAIT FOR DEADSTART TO COMPLETE. 


NOTE: THE DEADSTART TAPES ARE FOUND IN THE TAPE CABINET IN THE 
NORTHEAST CORNER OF THE S2 LAB. 


406 NOS/VE_DEADSTART_AND_INSTALLATION 


DO ENTER DOWNsCH2. SO NOS/VE CAN USE THE CHANNEL. 
O ENTER DOWNsCH32. SO NOS/VE CAN USE THE CHANNEL. 


D0 THE FOLLOWING FILE MUST 3€ AVAILABLE IN YOUR CATALGG ON THE 
$2 


TPXXXK CONTAINS A NOS/VE DEADSTART IMAGE. THIS MUST BE A COPY OF 
THE DU AL STATE DEADSTART IMAGES AVAILABLE FROM THE LINK 
PROCEDURES. 


0 IF YOU'VE NEVER DEADSTARTED NOS/VE FROM THE USER NUMBER FROM 
WHICH YOU WANT TO RUN OR ITF YOU WISH TO CHANGE THE CURRENT 
PARAMETER SETTINGS FOR YOUR PARTICULAR USER NUMBER» THEN DO A 
SETVE-. SETVE ASSUMES THE FILE TPXXXK IS IN YOUR USER NUMBER; 
YOU DO NOT HAVE TO DO ANOTHER SETVE IF TPXXXK HAS CHANGED 
SINCE THE LAST TIME YOU RAN. THE GENERAL FORM OF SETVE IS 


XeSETVE( PN=FFFFsUN=UNsC=6) 


WHERE FFFF IS AN IDENTIFIER OF UP TO 4 CHARACTERS AND UN IS 
THE USER NUMBER TO SEARCH FIRST FOR FILES» 6 IS THE NUMBER OF 
THE SYSTEM CORE COMMAND OECK FOR THE ARDEN HILLS $2 
CONFIGURATION. WARNING2_ SPECTEYING €=6_0N_THE. ARDEN HILLS__323 


WILL._OESTROY THE CLOSED SHOP PERMANENT _EILE BASE, IN GENERAL 
FFFF AND UN WILL BE THE SAMEs EoGe XeSETVE(DAHsUN=DAHsC=6) 


**ONLY ONE SETVE SHOULD BE DONE FOR EACH USER NUMBER AND A 
SETVE SHOULD NOT BE DONE FOR ANY INTEGRATION USER NUMBER 
EXCEPT BY THE INTEGRATION PROJECT.** 

SEE SECTION 5e1 FOR MORE DETAILS. 


0 BRING UP DUAL STATE 
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NVEFFFF. 


WHERE FFFF IS THE IDENTIFIER SPECIFIED IN SETVE» E.G. 
NVEINTI. 


O BRING UP THE OPERATOR FACILITY 
ENTER KsNVE. 


NOS/VE IS CURRENTLY GENERATED AND INITIALIZED ON BOTH NOS 
AND NOS/VE. ALL SOURCE AND OBJECT LIBRARIES THAT MAKE UP THE 
NOS/VE SYSTEM ARE PRODUCED ON NOS AND THEREFORE MUST BE 
CONVERTED FROM THEIR CI TO TI COUNTERPARTS. OTHER PARTS (OF 
INSTALLING AND INITIALIZING THE SYSTEM (EeGe BUILDING THE 
SSYSTEM CATALOG) ARE PERFORMED BY COMMAND LANGUAGE PROCECURES 
ON NOS/VE. SINCE THE SAME SYSTEM WILL BE DEADSTARTED MANY 
TIMES IN A CLOSED SHOP ENVIRONMENTs IT IS ADVANTAGEOUS TO ONLY 
PERFORM THE CONVERSION FROM CI TO II A SINGLE TIMES SAVE THE 
RESULTS IN THE NOS FILE SYSTEM AND THEN SIMPLY BRING THE FILES 
BACK DURING DEADSTART. 


THE ACTUAL FILES THAT GET INSTALLED AND LOADED ON EACH 
DEADSTART ARE DETERMINED BY A COMMAND LANGUAGE PROCEDURE (THE 
SYSTEM PROFILE) INTERPRETED ON NOS/VE. THIS PROCEDURE CAN BE 
MODIFIED BY EACH SITE TO INITIALIZE THEIR NOS/7VE ENVIRONMENT 
IN THE MOST SUITABLE FASHION. THE PROCESS OF BUILDING THE 
SYSTEM PROFILE AND OF PERFORMING THE CI TO II CONVERSIONS IS 
REFERRED TOG AS AN INSTALLATION DEADSTART AND THE PROCESS OF 
EXECUTING THE SYSTEM PROFILE AND OF FETCHING PREVICUSLY 
CONVERTED FILES FROM NOS AND MAKING THEM AVAILABLE IN THE 
NOS/VE FILE SYSTEM IS REFERRED TO AS A DEADSTART. A SINGLE 
COMMAND IS AVAILABLE TO PERFORM BOTH AN INSTALLATION DEADSTART 
AND A DEADSTART. 


e601 THE DS PROCEDURE AND PRODUCT INSTALLATION 
4e6elel THE _DS_PROCEDURE 

THE PURPOSE OF THIS COMMAND [S TO PERFORM AN INSTALLATION» 
NORMAL OR RECOVERY ODEADSTART OF NOS/VE. THE DEFAULTS FOR 
PARAMETERS ARE THOSE MOST CONVENIENT FOR "CLOSED SHOP" 
DEADSTARTS. 

THE PROCEDURE “BRINGS UP" THE JOB LOG DISPLAY ON THE LEFT 
SCREEN WHERE THE PROGRESS OF THE PROCEDURE MAY BE WATCHED» AND 
THE CONTROL POINT DISPLAY ON THE RIGHT SCREEN. JUST BEFORE THE 
PROCEDURE COMPLETES IT CHANGES THE LEFT SCREEN TO OISPLAY THE 
SYSTEM LOG AND WRITES TO THAT LOG THE MESSAGE 

fe—-— DEADSTART COMPLETED ----! 


AT WHICH POINT THE OPERATOR MAY ENTER COMMANDS. 
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DS CKIND=INSTALL 1 NORMAL 1 RECOVER] 
CGETLPRODUC TS=<BOOLEAND] 
CECHO=<BOOLEAN>D] 
CALTERNATE_USER=<NOS_USER _NAMED] 
CSAVE LINSTALL_FILES=<BOOLEAND] 
CVALIDATE_LUSERS=<BOOLEAND] 
CQUICK_VALIDATE=LIST GF <NAME>] 
CSTATUS*<STATUS VARIABLED] 


KIND 1 Kt THIS PARAMETER SPECIFIES WHAT KIND OF DEADSTART IS 
TO BE PERFORMED. VALID SPECIFICATIONS ARE 


INSTALL 12 I = INSTALLATION DEADSTART TO BE PERFORMED. 
THE SYSTEM LIBRARIES ARE BUILT FROM CI OBJECT FILES. 


NORMAL 1 N — NORMAL DEADSTART TO BE PERFORMED. THE 
SYSTEM LIBRARIES ARE OBTAINED FROM THE RESULTS OF A PREVIOUS 
INSTALLATION DEADSTART. 
RECOVER 1 R = RECOVERY DEADSTART. JUST INITIATES SYSTEM 
TASKS » PERMANENT FILES ARE "RECOVERED" FROM A PREVIOUS RUN 
OF THE SYSTEM. 
OMISSION WILL CAUSE A RECOVERY DEADSTART TO BE PERFORMED. 
GETLPRODUCTS 1 GPs THIS PARAMETER SPECIFIES WHETHER THE OBJECT 
LIBRARIES DEFINING THE CURRENT PRODUCT SET AND SCU LIBRARIES 
DEFINING THE SOURCE LIBRARIES ARE TO BE INSTALLED. VALID 
SPECIFICATIONS ARE 
TRUE 1 YES 1 ON — THE PRODUCTS ARE TO BE INSTALLED 
FALSE 1 NO 1 OFF — THE PRODUCTS ARE NOT TO BE INSTALLED 
THE LIST OF PRODUCTS INSTALLED ON THE ARDEN HILLS CLOSED 
SHOP $3 SYSTEM WHEN GET_PRODUCTS*YES IS SPECIFIED IS Given 
IN THE INSTALL PRODUCTS SECTION. 
OMISSION WILL CAUSE THE PRODUCT SET TO BE INSTALLED. 
ECHO 1 E% THIS PARAMETER SPECIFIES WHETHER THE COMMANDS SHOULD 
BE ECHOED TO THE CONSOLE DURING EXECUTION. VALID SPECIFICATIONS 
ARE 
TRUE 1 YES 1 ON - ECHO COMMANDS 
FALSE 1 NO 1 OFF = DO NOT ECHO COMMANDS 
OMISSION WILL CAUSE COMMANDS NOT TO BE ECHOED. 


ALTERNATE_LUSER 1 AUS THIS PARAMETER SPECIFIES WHAT NOS USER TO 
CHECK IF THE DEFAULT NVE USER DOES NOT HAVE THE NEEDED FILE. ANY 
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NOS USER NAME IS ALLOWED. 
OMISSION WILL CAUSE INT1 TO BE USED. 


VALIDATE_USERS 1 VU THIS PARAMETER SPECIFIES WHETHER TO RUN 
THE J08 THAT VALIDATES NOS/VE USERS.» THIS PARAMETER IS IGNORED 
FOR A RECOVERY DEADSTART. VALID SPECIFICATIONS ARE 


TRUE 1 YES 1 ON - RUN THE VALIDATION J08 
FALSE 1 NO 1 OFF ~ DO NOT RUN THE VALIDATION JOB 
OMISSION WILL CAUSE THE VALIDATION JOB TO BE RUN. 


QUICK _VALIDATE 1 OQV8 THIS PARAMETER DETERMINES WHICH USERS 
WILL BE VALIDATED BY THE VALIDATION JOB IF IT IS RUN. WHEN 
SPECIFIED» THIS PARAMETER GIVES A LIST OF USER NAMES TO BE 
VALIDATED IN ADDITION TO THE USERS? INT1s INT2s DEVI» DEV2s RELI» 
EVAL AND RKC. 


OMISSION WILL CAUSE ALL USERS TO BE VALIDATED. 


STATUS: SEE ERROR HANDLING IN THE NOS/VE ERS. 
NOTES 


THE GET SOURCE LIBRARIES PARAMETER HAS BEEN REMOVED. SCURCE 
LIBRARIES ARE NOW TREATED AS PRODUCTS AND THEIR INSTALLATION IS 
NOW CONTROLLED BY THE GET_LPRODUCTS PARAMETER. 


THE DEBUG PARAMETER HAS ALSO BEEN REMOVED. LATER IN THIS 
DOCUMENT THERE IS AN EXPLANATION OF HOW DS NOW HANDLES ABNCRMAL 
SITUATIONS. 


SUMMARY. OF. OS_ PROCESSING 


KIND_OF_ INSTALLATION PROCESSES PERFORSED 


Is No R A CONDITION HANDLER IS ESTABLISHED FOR 
ANY FAULT. IF SOMETHING GOES WRONG 
OURING THE DS PROCEDURE» IT WILL GET 
CONTROL» DISPLAY THE STATUS» AND LET THE 
CPERATOR INTERACT WITH THE OS PROCEDURE. 
THE OPERATOR CAN ENTER COMMANDS TO 
INVESTIGATE AND/OR CORRECT THE PROBLEM>» 
RESUME EXECUTION OF DS BY ENTERING 
CONTINUEs OR ABORT DS BY ENTERING 
EXIT_PROC. 


Is No R THE PROCEDURE “BRINGS UP" THE JOB LOG 
| DISPLAY (ON THE LEFT SCREEN) WHERE THE 
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PROGRESS OF THE DS PROCEDURE MAY BE 
WATCHED», AND THE CONTROL POINT DISPLAY 
(ON THE RIGHT SCREEN). 


I ONLY SYSTEM FILES ARE CREATED FROM 170 CI 
BINARIES FOR 


CYFSRUN_TIME_LIBRARY 
GSFSOPERATOR_LIBRARY 
OSFSSYSTEM_LIBRARY 

OSF SOPERATOR_COMMAND_LIBRARY 
OS FSCOMMAND LIBRARY 


IF SAVELINSTALLIFILES=YES>» THE II 
BINARIES OF THE ABOVE FILES ARE REPLACED 
ON THE 170. 

N ONLY SYSTEM FILES ARE ACCESSED FROM 170» THESE 
ARE THE REPLACED II BINARIES MENTIONED 
ABOVE. | 

Ts Ns R REMOTE HOST OUTPUT IS STARTED. 

IT» N SYSTEM AND USER PROLOGS AND EPILCGS ARE 
BUILT. | 

I> N THE VALIDATION JOB [IS SUBMITTED AND 


SYSTEM STATISTICS ARE OUTPUT. 


I» N IF GETLPROOUCTS#YESs» THE PRODUCT SET AND 
SOURCE LIBRARIES ARE INSTALLED$ FAILED 
PRODUCT SET OR SOURCE LIBRARY 
INSTALLATIONS WILL PRINT A JOB LOG. 


Ip N WAIT FOR VALIDATION JOB TO COMPLETE. 

Ip No R RHINPUT» IFEXECs DUMP_BROKEN_JOB TASKS 
ARE STARTED. 

Iy N FEEDBACK CAPABILITY SET UP. 

Is Ns R SCL TASK STARTED. 


JOB LOG PRINTED.. 
THE FOLLOWING MESSAGE IS OUTPUT 


“~~ DEADSTART COMPLETED -- 


THE BIGGEST CHANGE TO THE DS PROCEDURE IS IN THE PRODUCT SET 
INSTALLATION (GET_PRODUCTS=YES). A PROCEDURE CALLED 
INSTALL_PRODUCTS IS USED TO INSTALL THE ENTIRE PRODUCT SET 
(PRODUCT SET AND SOURCE LIBRARIES). IN THIS PROCEDUREs A JOB [5 
SUBMITTED FOR EACH PRODUCT» IN EACH JOB A GETLPRODUCT IS 
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EXECUTED.» THE PRODUCTS ARE INSTALLED IN THE $SYSTEMeLIBRARY 
CATALOG UNDER THE PRODUCT NAME. THE SUBMITTED JOBS CAN BE VIEWED 
ON A RIGHT K DISPLAY» THE LEFT K DISPLAY SHOWS THE PROCESSING OF 
THE DS PROCEDURE. 


UPON JOB COMPLETIONs A SUCCESS OR FAILURE MESSAGE WITH THE JOB 
NAME (REFLECTING THE PRODUCT BEING INSTALLED» I.€. CYISCOMPILER 
FOR PRODUCT CYFSCOMPILER = THE CYBIL II COMPILER) IS WRITTEN TD A 
STATUS FILE (DSFSPROCUCT_JOB_LSTATUS). THE CONTENTS OF THIS FILE 
IS USED TO MAKE SURE ALL THE PRODUCT JOBS HAVE COMPLETED BEFORE 
CONTINUING WITH THE DS PROCEDURE» AS WELL AS THE CONTENTS BEING 
DISPLAYED TO THe J08 LOG WHICH CAN BE VIEWED BY THE OPERATOR. 


IF A PRODUCT INSTALLATION FAILS» SEVERAL THINGS HAPPEN 


~ A FAILURE MESSAGE WITH JOB NAME IS WRITTEN TO THE STATUS 
FILEs WHICH WILL SUBSEQUENTLY BE DISPLAYED TO THE OPERATOR. 


~ JHE JOB LOG FOR THE FAILED PRODUCT INSTALLATION WILL BE 
PRINTEDs INDICATING THE ERROR. 


- AT THE END OF THE INSTALLLPRODUCTS PROCEDUREs IF ANY 
PRODUCTS HAVE FAILEDs THE CONDITION HANDLER ESTABLISHED AT 
THE START OF THE OS PROCEDURE GETS CONTROL. A STATUS 
MESSAGE OF “"N PRODUCT INSTALLATIONS FAILED" IS DISPLAYED 
AND A PROMPT FOR OPERATOR INTERACTION OCCURS. THE OPERATOR 
AT THIS POINT CAN ATTEMPT REINSTALLATION OF FAILED PRODUCTS 
THROUGH THE USE OF INSTALL_PRODUCTS OR JUST CONTINUE WITH 
THE DS PROCEDURE. 

THERE ARE TIMES WHEN IT IS NECESSARY TO RECREATE THE SYSTEM 
LIBRARIES - NEW PROCEDURES TO BE ADDED TO THE OPERATOR/SYSTEM 
COMMAND LIBRARIES» NEW VERSTONS OF THE CYBIL RUN TIME 
LIBRARY/OBJECT CODE UTILITY- BUT STILL MAINTAIN THE PERMANENT 
FILE BASE. THIS CAN BE ACCOMPLISHED VIA THE FOLLOWING CALL TO 
THE DOS PROCEDURE 


DS KIND=I SIF=TRUE VU=NO 
THIS WILL REBUILD AND REPLACE THE SYSTEM LIBRARIES» BUT NOT GO 
THROUGH THE VALIDATICIN JOB RECREATING THE FAMILIES AND USERS. 


4e601.2 THE GET PRODUCT PROCEDURE 


GETLPRODUCT PRODUCT =<NAME> 
FILE=<1L70_FILE_NAME> 
USER2<170_ USER NAME> 
CCATALOG=<180_C ATALOG_REFERENCED] 
CFILE_CONTENTS=<NAMED] 
CFILELSTRUCTURE=<NAME>] 
CFILE_PROC ESSOR=<NAMED] 
CRING_ATTRIBUTES*LIST 3.2.3 OF <INTEGERD] 
CSTATUS=STATUS_ VARIABLE] 
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PRODUCT 1 P: NAME OF THE PRODUCT 


FILE 1 F? NAME OF THE 170 FILE THAT CONTAINS THE B56 FORM OF 
THE PRODUCT. 


USER 1 Ut NAME OF THE 170 USER THAT OWNS "FILE". 

CATALOG 1 C? NAME OF THE CATALOG IN WHICH THE PRODUCT IS TO BE 
INSTALLED. 
OMISSION WILt CAUSE SUSER TO BE USED. 

FILE_CONTENTS 1 FILE_LCONTENT 1 FC? THE VALUE FOR THE PRODUCT 
FILE'S FILELCONTENTS ATTRIBUTE, 
OMISSION WILL CAUSE OBJECT TO BE USED. 

FILE-STRUCTURE 1 FS: THE VALUE FOR THE PRODUCT FILE'S 
FILE_STRUCTURE ATTRIBUTE. 
OMISSION WILL CAUSE LIBRARY TO BE USED. 

FILE_PROCESSOR 1 FPS THE VALUE FOR THE PRODUCT FILE'S 
FILE_PROCESSOR ATTRIBUTE. 
OMISSION WILL CAUSE UNKNOWN TO BE USED. 

RING_LATTRISUTES 1 RA’ THE VALUES FOR THE PRODUCT FILE*S 
RING_LATTRIBUTES ATTRIBUTE. 
OMISSION WILL CAUSE (11511511) TO BE USED. 

STATUS? SEE ERROR HANDLING IN THE NOS/VE COMMAND INTERFACE 
ERS. 
4e6ele3 INSTALL PRODUCTS PROCEDURE 


THE INSTALL_PRODUCTS PROCEDURE CAN BE USED AS AN INDEPENDENT 
COMMAND TO OO AN INSTALLATION/REINSTALLATION AT THE OPERATOR'S 
DISCRETION. 
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IF GET_PRODUCTS=YES» ALL OF THE FOLLOWING WILL BE INSTALLED. 


C170 


PRODUCT NAME : 

ELLE {C180_FILED FILE CONTENTS 

CYFIIC CYFSCOMPILER CYBIL II COMPILER 

ALFOL ALF SOBJECT_LIBRARY 180 ASSEMBLER 

SC FOL SCFSOBJECT_LIBRARY SOURCE CODE UTILITY 

SCFCL SCFSCOMMAND LIBRARY SOURCE CODE UTILITY 
"STAND-ALONE" COMMAND 
LIBRARY 

IFFEDIT IFFSEDITOR JACK BOHNHOFF'S EDITOR 

PSFCL PSFSCOMMAND_LIBRARY PRODUCT SET COMMANDS 

AAF44D AAFS44D_ LIBRARY AAM LIBRARY 

AAF4DD AAFS4DD_LIBRARY AAM=FORTRAN INTERFACE 

CBF7DD CBFS7DD_LIBRARY COBOL COMPILER 

CBF40D CBFS4DD_LIBRARY COBOL RUN-TIME LIBRARY 

CCFLIB CCFSELIBRARY COMMON COMPILER MODULES 

CGFLIB CGFSLIBRARY COMMON CODE GENERATOR 

DBFLIB ODBFSLIBRARY DEBUG LIBRARY 

FCFLIB FCFSLIBRARY FORTRAN COMPILER 

FLFLIB FLFSLIBRARY FORTRAN RUN-TIME 

FMFLIB FMFSLIBRARY FILE MANAGEMENT UTILITY 

MLFLIB MLFSLIBRARY MATH LIBRARY 

SMFLIB SMFSLIBRARY SORT=MERGE 

TTFLI8 TTFSTEST_TOOL_LIBRARY TEST TOOL LIBRARY — ACR & 
EXAMINE 7 

OSFPIL OQSFSPROGRAM_INTERFACE_LIBRARY OPERATING SYSTEM PROGRAM 
INTERFACE 

OSFSL OSFSSOURCE_LIBRARY SUBSET OF OPERATING SYSTEM 


SOURCE LIBRARY 


INSTALL. PRODUCTS. PROCEDURE 


INSTALLLPRODUCTS CPRODUCTS=LIST OF <NAMED 1 ALL] 
CSTATUS=STATUS_ VARIABLE J 


PRODIJCTS 1 PRODUCT 1 P3 THE NAMES OF ONE OR PRODUCTS TO BE 
INST ALLE De: 


OMISSION WILL CAUSE ALL PRODUCTS TO BE INSTALLED. 


STATUS: SEE ERROR HANDLING IN THE NOS/VE COMMAND INTERFACE 
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ERS. 


40602 EXAMPLE OF NOS/VE INSTALLATION DEADSTART 


TYPE 


Ka NVEe 

KeSETLA (YOUR_LUNsNVE) YOUR PASSWORD 
KeGETF DS U=SCAT 

KeDS INSTALL GP=NQ AU=SCAT 


40603 EXAMPLE OF NOS/VE “NORMAL” DEADSTART 
THE INTEGRATION SYSTEM HAS HAD THE INSTALLATION DEADSTART RUN 
ON ITe ALSO THE FILES PRODUCED BY THE INSTALLATION DEADSTART 


HAVE BEEN MADE SEMI-PRIVATE AND ARE FOUND ON THE CATALOG USED IN 
THE NVEXXXX CALL. 


TYPE (WHERE DEV1 IS THE SAME AS THE XXXX IN THE NVEXXXX CALL) 


K»NVE. 
KeSETLA (DEVIsNVE) DEVIX 
KeGETF DS 


KeDS NORMAL 
40604 EXAMPLE OF NOS/VE RECOVERY DEADSTART 

THIS IS THE KIND OF DEADSTART THAT SHOULD MOST FREQUENTLY BE 
DONE IN A "CLOSED SHOP" ENVIRONMENT AND CONSEQUENTLY IS THE ONE 


FOR WHICH ALL THE PARAMETER DEFAULTS ARE ORIENTED. IT 
PRESUPPOSES THAT PERMANENT FILE RECOVERY HAS BEEN SUCCESSFUL. 


TYPE (WHERE DEV1 IS THE SAME AS THE XXXX IN THE NVEXXXX CALL) 


K» NVE 2 

KeSETLA (DEVIsNVE) DEV1X 
KeGETF DS 

K.DS 


40605 EXAMPLE OF MINIMAL NOS/VE DEADSTART 


THE MINIMAL DEADSTART SHOWN BELOW MAY BE USEFUL TC 05S 
DEVELOPERS WHO NEED TO GET THE SYSTEM UP QUICKLY AND DO NOT NEED 
THE PRODUCT SET OR ALL VALIDATED USERS. 
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TYPE 


Ka NVE. 

KeSETLA (YOQUR_LUNsSNVE) YOUR_L PASSWORD 
KeGETF DS U=SCAT 

KeDS NORMAL GP2N0 QY=YQUR_LUN AU2SCAT 


4.6.6 USE OF THE QUICK_DEADSTART COMMAND 


THIS COMMAND IS INTENDED AS A DEVELOPMENT TOOL TO FACILITATE 
'FAST® DEADSTARTS WHERE RECOVERY IS NOT NEEDED$ INDEED, IF THIS 
COMMAND IS ENTERED RECOVERY WILL_NOT_BE_PERFORMED WHEN THE SYSTEM 
IS BROUGHT DOWN FOR WHATEVER REASON. SPECIFYING THIS COMMAND 
WILL CAUSE AN INSTALLATION DEADSTART TO TAKE PLACE, IF THE 
INITOD COMMAND IS NOT SPECIFIED THEN A DEFAULT VALUE OF 'VSNOC1' 
IS USED FOR THE SYSTEM DEADSTART DEVICE. USE OF INITDOD WILL 
ALLOW SETTING THE DEADSTART DEVICES IDENTIFIER TO ANY VALUE. 
THIS COMMAND WILL NOT BE ACCEPTED FROM A DEADSTART COMMAND FILE> 
SO 'D=T*' MUST BE SPECIFIED ON THE SETVE PROCEDURE TO PERMIT ENTRY 
DF THE QUICKDS COMMAND. 


FORMAT: QUICKDS OR QUICK _DEADSTART 

VALUES? THE DEFAULT IS FALSE. EXECUTING THIS COMMAND CAUSES 
THIS INITIAL VALUE TO BE TOGGLEDs THUS EXECUTING THIS COMMAND 
TWICE WILL CAUSE THE FINAL VALUE TO BE FALSE. 

NOTE? QUICK_TEMPLATE_LOAD DOES NOT EXIST NOW. 
4.7 NOSZVE_INTERACTIVE FACILITY OPERATION 
427.1 OPERATOR INITIATION 


TO BRING UP THE NOS/VE INTERACTIVE FACILITY DO THE FOLLOWING 
1) BRING UP NOS/VE. 
2) BRING UP NAM 
AT THE SYSTEM CONSOLE ENTER 
NAM. 
WITH THE 56 NETWORKS» A FLASHING REQUEST FOR A DUMP TAPE 
WILL APPEARs ENABLING THE OPERATOR TO DUMP A PREVIOUS 
NETWORK CRASH AETER BRINGING NAM & FRIENDS UP AGAIN. IF 


YOU DON'T WANT A DUMP ENTER ASSIGNs JSN 977. FOR THE 
APPROPRIATE JOB. 
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3) IF TAF ITS NOT UP AT CONTROL POINT 1s ENTER 


4e702 


IAF. 


DPERATOR TERMINATION 


TERMINATE NOS/VE INTERACTIVE 00 EITHER OF THE FOLLOWING 


PREFERRED METHOD 


Ky NAM, 
K »eAP=NVF. 
Ke DI>sAP=VEIAF. 


TO BRING VEIAF 
Ks NAM. 
K.AP2=NVF, 

Ke EN» AP=VEIAF. 
X.DIS. 

IITPPAS. 

DROP. 

SECOND METHOD 


IDLE» NAM. 


BACK UPs YOU MUST 00 


IDLE» IAF. (DON'T IDLE YAF WHEN IAFEX2 I5 EXECUTING 
DR A PP WILL HANG.) 


THIS TERMINATES THE ENTIRE NETWORK INCLUDING IAFs RBFs ETC. 
SHJULD BE USED ONLY IF YOU HAVE NO_LINIENTION OF BRINGING 
VEIAF BACK UP BECAUSE THE 170 AND 180 SIDES OF VEIAF GET UT OF 
SYNCH WHEN THE NETWORK IS BROUGHT DOWN THIS WAY. 


AND 


407e3 QTHER OPERATOR CAPABILITIES 


- TQ LOGICALLY TURN THE PRINTER ONs UNDER DSD ENTER 


ON 


- TO 


933-4 


SEND A "SHUTDOWN WARNING" TO ALL TERMINALS LOGGED ON TO 
VEIAF DO 


K»NAM. 
KeAP=NVF. 
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K eI Ds AP=VEIAF. 


- TO SEND A MESSAGE TO ALL TERMINALS DOD 


CFOoNAM oMSGsALL »MESS AGE. Ka NAM. 
KeAP=CS. 
K eNPUZNPUNAME » MESSAGE. 
NPUNAME=SN1147 ON THE S2> 
=5N1322 CN THE S3. 


- PASSIN HAS THE ABILITY TO RECORD VARIOUS TYPES OF DIAGNOSTIC 
INFORMATION. THIS CAPABILITY IS CONTROLLED VIA THE SENSE 
SWITCHES AT THE PASSON CONTROL POINT. TO TURN A SENSE SWITCH 
ON (OFF) AT JOB JSN 00 


DNSWs ISN sXe COFFS WsJSNoX.) 


WHERE xX IS THE DESIRED SENSE SWITCH (1 TO 6). THE PASSON 
DEFAULT IS ALL SENSE SWITCHES OFF. IT WILt TAKE A SHORT 
PERIOD OF TIME BEFORE PASSON DETECTS A CHANGE IN A SENSE 
SWITCH AND REACTS TO IT. THE SENSE SWITCHES CURRENTLY USED BY 


PASSON ARE 
SWIICh_# QSE 
1 NETWORK TRACE 
2 PASSON LOGIC TRACE TO DAYFILE 
3 MEMORY LINK TRACE TO DAYFILE 


4.8 NOS/VE_ OPERATOR FACILITY AND OPERATOR. COMMANDS 


WITH THE RELEASE OF THE OPERATOR FACILITY PHASE 1 SEVERAL 
CHANGES TO THE NOS/VE OPERATING SYSTEM WILL OCCUR THAT WItl 
EFFECT THE USERS OF THE NOS/VE OPERATORS CONSOLE. THE OPERATOR 
FACILITY RUNS AS PART OF THE NVE CONTROL POINT. WHEN THE REQUEST 
FOR K DISPLAY APPEARS ON THE NOS B DISPLAYs ASSIGN THE K DISPLAY 
TO THE NVE CONTROL POINT. THE OPERATOR FACILITY IS CAPABLE OF 
DISPLAYING BOTH A LEFT AND A RIGHT SCREEN AREA AT THE SAME TIME. 
IF THE OPERATOR WANTS BOTH SCREENS THEN TYPE IN KKe THE CONTENTS 
OF THESE DISPLAYS ARE DETERMINED BY THE COMMANDS ENTERED BY THE 
OPERATOR. 


THE LEFT SCREEN IS DIVIDED INTO FOUR DIFFERENT AREAS. THE TOP 
MOST AREA IS THE SYSTEM HEADER WHICH CONTAINS THE CURRENT DATE 
AND TIMEs MEMORY STATISTICS» AND AN OPERATOR ACTION MESSAGE IF 
ONE IS POSTED. THE GPERATOR ACTION WILL INCLUDE THE JOB SEQUENCE 
NUMBER OF THE OWNER OF THE MESSAGE AND "MESSAGE CANCELLED*® IF THE 
MESSAGE IS CANCELLED BECAUSE THE TASK HAS TERMINATED. THE NEXT 
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LINE CONTAINS THE FIRST 64 CHARACTERS OF THE GPERATOR ACTION 
MESSAGE (60 CHARACTERS IN STAND ALONE). 


THE NEXT AREA OF THE SCREEN IS THE MAIN OUTPUT AREA. THIS 
AREA HAS THE FILE NAME OF GUTPUT. ANY DISPLAY COMMAND CAN HAVE 
ITS OUTPUT DIRECTED TO THIS AREA AS WELL AS ANY SYSTEM COMMAND. 


THE THIRD AREA IS TOWARDS THE BOTTOM OF THE SCREEN. THIS AREA 
IS TWO LINES LONG AND CONTAINS THE RESPONSE AREA. THIS WILL 
CONTAIN ERROR MESSAGES FROM SYSTEM COMMANDS. THE AREA IS CLEARED 
WHEN THE NEXT OPERATOR TYPEIN IS ENTERED AT THE OPERATOR'S 
CONSOLE AND RECEIVED BY NOS/VE. 


THE FOURTH AREA IS THE PROMPT AREA. THIS WILL CONTAIN THE 
STATUS OF THE KEYBOARD. IF NOS/VE IS PROCESSING A COMMANDs THEN 
THE KEYBOARD ITS LOCKED AND ALL TYPEINS WILL BE IGNORED.» WHEN THE 
KEYBOARD IS LOCKEDs THE MESSAGE "DATA RECEIVED BY 180 ~ KEYBOARD 
LOCKED*® WILL APPEAR AT THE SCREEN'S BOTTOM. WHEN THE KEYBOARD IS 
UNLOCKED THEN ANY DATA IN THE KEYBOARD BUFFER WILL BE SENT TO 
NOS/VE.- THE BOTTOM LINE IS THE LAST LINE THAT WAS PROCESSED BY 
OPERATOR FACILITY. 


THE RIGHT K DISPLAY HAS THE FILE NAME OQUTPUTLRIGHT. THERE IS 
ONLY ONE AREA ON THE RIGHT SCREEN THEREFORE THE MAIN DISPLAY AREA 
TS 10 LINES LONGER THAN THE LEFT SCREEN AREA. IF A DAYFILE 
DISPLAY OR AJ DISPLAY IS SHOWN ON THE RIGHT SCREEN YOU WILL GET 
MORE LINES OF INFORMATION THAN ON THE LEFT SCREEN. 


THERE ARE NO DEFAULT DISPLAYS THAT COME UP AUTOMATICALLY ON 
EITHER OUTPUT DISPLAY AREA. IT IS UP TO THE OPERATOR TO DECIDE 
THE DISPLAY THE OPERATOR WISHES TO SEE. THE GNLY PARTS OF THE 
DISPLAY THAT COME UP AUTOMATICALLY IS THE SYSTEM HEADER DISPLAY 
AND THE PROMPT AREA FOR KEYBOARD STATUS. 


THE PAGE WIDTH OF THE SCREEN IS 60 CHARACTERS FOR STANDALONE 
AND 64 CHARACTERS FOR DUAL STATE. THE CHARACTER SET TRANSLATION 
CODE IS THE SAME AS THAT FOR THE CURRENT NVE SUBSYSTEM CONTROL 
POINT. THE ESCAPE CODE SEQUENCE FOR THE SPECIAL CHARACTERS 10 BE 
TYPED HAS NOT CHANGED. THERE ARE A FEW DIFFERENCES IN THE 
PROCESSING OF DATA BY THE OPERATOR FACILITY AND NVE SUBSYSTEM. 


1) 00 NOT END COMMANDS WITH A PERIOD. PERTODS ARE SENT TC 
NOS/VE. 


2) THE NVE SUBSYSTEM COMMANDS THAT BEGIN WITH AN ASTERISK WILL 
NOT BE SUPPORTED FROM THE OPERATOR FACILITY CONTROL POINT. IF 
THESE COMMANDS ARE ENTERED FROM THE OPERATOR FACILITY THEY 
WILL BE PASSED GN TO SCL WHERE AN ILLEGAL COMMAND WILL BE 
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ISSUED. 


3) ROUTING OF CONSOLE JOB DATA TO A SPECIFIC JOB BY THE 
"N=COMMAND? PROTOCOL WILL NOT BE SUPPORTED IN DUAL STATE. 
THIS FEATURE SHOULD WORK IN STANDALONE BUT WILL NOT BE 
SUPPORTED. 


4) NO TYPE AHEAD = COMMANDS CANNOT BE ENTERED UNTIL THE PROMPT 
AREA SHOWS THAT THEY ARE REQUESTED. | 


THERE IS ONE NEW COMMAND TO REPLACE THE CURRENT DISPLAY 
COMMANDS. THE ENTRY POINTS FOR ZDISs ZDISBs AND SDIS HAVE BEEN 
DELETED. THE NEW COMMAND IS VEDISPLAY AND HAS TWO PARAMETERS. 
THE OPTIONS ARE LISTED BELOW. THE VALUES IN PARANTHESIS ARE THE 
ABBREVIATIONS.» NOTE THAT THIS COMMAND DOES NOT BEGIN WITH AN 
ASTERISK (#). THIS COMMAND WILL BE PROCESSED BY SCL AND CREATE A 
NEW SYSTEM CONTROL POINT TASK TO DISPLAY IT'S DATAs THE USER CAN 
HAVE THE SAME DISPLAY TYPE ON EACH OF THE DISPLAY AREAS» IF THE 
USER SO DESIRES. 


COMMAND NAME DISPLAY TYPE SCREEN AREA 
PARAMETER NAME PARAMETER NAME 
DISPLAY_OPTIONS OUTPUT (0) 


DISPLAY_LOPTION (00) 


PARAMETER VALUES PARAMETER VALUES 
VEDISPLAY (VED) DISPLAY_SYSTEM_LOG GUTPUT 
JQBLLOG (JL) OUTPUT_LRIGHT (OR) 
ACTIVE_JOB8S (AJ) 
THE DEFAULT FILE NAME FOR ALL DISPLAYS IS OUTPUT. 


THE FOLLOWING IS A BRIEF LIST OF COMMANDS TO BRING UP NOSVE 
WITH THE OPERATOR FACILITY INSTALLED. 


NVEFFFF. TO BRING UP NOS/VE. (SEE SECTION 5) 

Ky NVEe 

KK « | TO BRING UP THE K DISPLAY ON BOTH SCREENS. 
ie JL TO BRING UP THE JO8 LOG. 


Ke VED DISPLAY_OPTIONS=JL OUTPUT =DUT PUT 
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TO BRING UP THE JOB LOG USING KE Y WORD 
IDENTIFIERS. 


KeVED AJ OUTPUT_LRIGHT 
TO BRING UP THE CONTROL POINT DISPLAY ON THE 
RIGHT SCREEN. 


OR 
KeVED DISPLAY_LOPTIONS=CONTROL POINT OUTP UT=OUTPUT_ RIGHT 
TO BRING UP THE CONTROL POINT DISPLAY USING 
KEY WORD IDENTIFIERS. 


Ko XXX SEND ANY COMMAND TO NOS/VE. 


Ke TERMINATE SYSTEM TO TERMINATE NOS/VE. 


NOTE: AFTER THE DS PROCEDURE HAS COMPLETED EXECUTION THE 
COMMAND TO ENTER TO BRING DOWN THE SYSTEM IS TERMINATE_SYSTEMs 
NOT TERMINATELSYSTEM_J08B. YES» THIS IS THE OPPOSITE OF WHAT IT 
USED TO BE. | 


4.8.1 DELETE_JOBLQUEUE 1 DELETELJOBLQUEVES 1 DELJO 


THE PURPOSE OF THIS COMMAND [S TO DELETE ALL FILES FROM THE 
JOB INPUT SUBCATALOGs THE PRINT SUBCATALOG OR BOTH. THIS COMMAND 
IS ONLY ALLOWED FROM JOBS WITH OPERATOR AND OR SYSTEM PRIVILEGES. 

DELETE_JOBLQUEUE [QUEUE _NAME=INPUTLOUTPUTIUALL I 

CSTATUS=<STATUS VARIABLED] 


QUEUE NAME i QN: THIS PARAMETER SPECIFIES FROM WHICH 
SUBCATALOGS FILES ARE TO BE DELETED. SPECIFYING INPUT WILL CAUSE 
ALL FILES TO BE DELETED FROM THE JOB SWAP SUBCATALOG AND THE J08 
INPUT SUBCATALOG. SPECIFYING OQUTPUT WILL CAUSE ALL FILES TC 8E 
DELETED FROM THE JOB QUTPUT SUBCATALOG. OMISSION WILL CAUSE ALL 
TO BE USED. 


STATUS? SEE ERROR HANOLING. 
4.8.2 REBUILDLINPUT_QUEUE 1 REBIQ 


THE PURPOSE OF THIS COMMAND IS TO REBUILD AN ENTRY IN THE 
KNOWN JOB LIST (KJL) FROM INFORMATION IN THE SYSTEM LABEL OF THE 
FILE REPRESENTING THE JOB BEING PROCESSED. THIS COMMAND I3 10 BE 
USED DURING THE PROCESS OF RECOVERING THE INPUT QUEUES DURING 
RECOVERY DEADSTART. 

REBUILDLINPUT_LQUEUE CNAME=<NAMED] 

CSTATUS=<STATUS VARIABLED] 


NAME 1 N2 THIS PARAMETER SPECIFIES THE FILE NAME OF THE FILE 
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REPRESENTING THE JOB. AN ATTEMPT IS MADE TO PROCESS THE 
SPECIFIED FILE WITHIN THE CATALOG WHERE JOB INPUT QUEUES ARE 
KNOWN TO RESIDE. 


STATUS?! SEE ERROR HANDLING. 
4.8.3 REBUILD_OUTPUT_QUEUE 1 REBDO 


THE PURPOSE OF THIS COMMAND IS TO REBUILD AN ENTRY IN THE 
KNOWN QUTPUT LIST (KOL) FROM INFORMATION RETAINED IN THE SYSTEM 
LABEL OF THE FILE REPRESENTING THE OUTPUT BEING PROCESSED. THIS 
COMMAND IS TO BE USED DURING THE PROCESS OF RECOVERING THE OUTPUT 
QUEUES DURING A RECOVERY DEADSTART. 

REBUILD _OUTPUT_QUEUE [CNAME=<NAME>} 

CSTATUS=<STATUS VARIABLED} 


NAME? THIS PARAMETER SPECIFIES THE FILE NAME OF THE FILE 
REPRESENTING THE dOUTPUT. AN ATTEMPT IS MADE TO PROCESS THE 
SPECIFIED FILE WITHIN THE CATALOG PATH OF WHERE JOB OUTPUT QUEUES 
ARE KNOWN TO RESIDE. 


STATUS: SEE ERROR HANDLING. 
NeNeN ACTIVATELSYSTEM_TASK 1 ACTST 


THE PURPOSE OF THIS COMMAND IS TO INITIATE ANY OF THREE TASKS 
TYPICALLY INITIATED FROM THE DS PROC. 

ACTIVATE_LSYSTEM_LTASK TASK_INAMES = <LIST OF <RHINPUTs RHOUTPUT >» 
IFEXEC>> 

CSTATUS =<STATUS_VARIABLE>] 
NeNeN DEACTIVATELSYSTEM_TASK 1 DEAST 


THE PURPOSE OF THIS COMMAND IS TO TERMINATE ANY OF THREE TASKS 
TYPICALLY INITIATED FROM THE DS PROC. 

DEACTIVATE_LSYSTEMLTASK TASKLNAMES = <LIST OF CRHINPUT >» 
RHOUTPUT» IFEXEC>> 

CSTATUS=<STATUS_VARIABLE>] 


409 ROUTE AN INPUT _FILE_ FROM .€170_TO_€180 


THROUGH THE SYSTEM CONSOLEs ENTER 


XeDIS. 
YSER»sAs3. 
GET»sFILENAME. 
WHERE FILENAME IDENTIFIES THE INPUT FILE TO BE ROUTED. 
ROUTE sFILENAMEsDC=LP »FC=RH, 
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4010 CONFIGURATION MANAGEMENT 


IN ORDER TO RUN NOS/VE IN A DUAL STATE ENVIRONMENT» CERTAIN 
HARDWARE CONFIGURATION RULES MUST BE IN EFFECT.» ALL STORAGE 
DEVICES AND CHANNELS THAT NOS/VE WILL REQUEST MUST BE IN A "DOWN? 
STATE IN THE NOS EST» FOR MORE INFORMATION ON THE NOS ESTs SEE 

THE NOS VERSION 2 OPERATOR/ ANALYST HANDBOOKs 60459310» SECTION 4. 
REFER TO THE £ DISPLAY. 


TO RUN S2 S/N 104 IN THE STANDARD CONFIGURATION» CHANNELS 2 
AND 32 MUST BE DOWNED AS SHOWN BELOW. 


DOWN sCH2 
DOWN» CH32. 


4.10.1 SYSTEM CORE COMMANDS 


CONFIGURATION MANAGE MENT (CM) SYSTEM CORE COMMANDS DEFINE THE 
SYSTEM MASS STORAGE DEVICE. THE COMMANDS ARE DESCRIBED IN DETAIL 
IN THE NOS/VE INSTALLATION COMMAND INTERFACE ERS» SECTION 3. THE 
CM SYSTEM CORE COMMANDS DEFINE THE HARDWARE CONFIGURATION OF THE 
SYSTEM DEVICE AND THE CONTROLLER ACCESSING THE SYSTEM DEVICE. AN 
EXAMPLE FOR S2 S/N 104 I3 SHOWN HERE. 


SETOCT $7155 1 
SETDD $885_11 40(8) 


4610.2 J08 TEMPLATE COMMANDS 


DURING AN INSTALLATION DEADSTARTs THE PHYSICAL CONFIGURATION 
UTILITY (PCU) AND THE LOGICAL CONFIGURATION UTILITY (LCU) MUST BE 
RUNe THE PCU IS RUN TO DESCRIBE THE PHYSICAL CONFIGURATION THAT 
NOS/VE MAY ACCESS. THE LCU WILL LOGICALLY INSTALL ALL OR PART OF 
THE PHYSICAL CONFIGURATION AND ALLOW NOS/VE TO ACCESS THE 
EQUIPMENTe COMMANDS FOR BOTH UTILITIES ARE DESCRIBED IN THE 
NOS/VE INSTALLATION COMMAND INTERFACE ERS» SECTION 2. 


THE SYSTEM DEVICE WHICH WAS DEFINED BY THE SYSTEM CORE 
COMMANDS MUST THE DEFINED VIA THE PCUs USING THE SAME CONTROLLER 
AND CHANNEL NUMBER. ADDITIONAL DEVICES MAY BE DEFINED AS LONG AS 
THE DEVICE IS IN A DOWN STATEs AND ALL CHANNELS DEFINED ARE ALSC 
DOWN.» AN EXAMPLE IS LISTED HERE. 


EXECUTE_TASK SP=MANAGE_PHYSICAL_CONFIGURATION 
SETLMAINFRAME_DEFINITION MAINFRAME=S2 
SETUDATALCHANNEL_ DEFINITION CHANNEL NUMBER=2 
SETLDATALCHANNEL_DEFINITION CHANNEL _NUMBER=18 
SETL-CONTROLLER_ DEFINITION ELEMENT*CT1 o- 
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PRODUCTLIDENTIFICATION=$7155_1 o- 
SERIAL_NUMBER=2 CHANNEL_CONNECTION=CHANNEL2 
SETLCONTROLLER DEFINITION ELEMENT=CT2 .. 
PRODUCTLIDENTIFICATION=$7155_1 4. 
SERTAL_NUMBER=3 CHANNEL CONNECT IGN=CHANNEL18 
SETLSTORAGE_DEVICE_DEFINITION ELEMENT=FMDG0_A o. 
PRODUCTLIDENTIFICATION=$885_11 SERTAL.NUMBER=1234 .- 
UNITLUNUMBER=40(8) CONTROLLER_CONNECTION=CT1 
SETLSTORAGE_DEVICE_ DEFINITION ELEMENT=FMD40_B .. 
PRODUCTLIDENTIFICATION=$855_11 SERTAL NUMBER =3456 2. 
UNITLNUMBER=40(8) CONTROLLER CONNEC TION=CT2 
INSTALL PHYSICAL_CONFIGURATION MAINFRAME=S2 
QUIT 


EXECUTEL TASK SP=MANAGE LOGICAL CONFIGURATION 
INSTALL _ LOGICAL CONFIGURATION INCLUDE=ALL 
QUIT | 


4210.3 MULTIPLE VOLUME CONSIDERATIONS 


IF A CONFIGURATION IS USED DEFINING MULTIPLE MASS STORAGE 
VOLUMES» THE EXECUTION CF THE PCU AND LCU WILL ONLY PERMIT ACCESS 
TO THE SYSTEM DEVICE. IN ORDER TQ BRING ADDITIGNAL VOLUMES 
ONLINEs THE LCUY MUST BE RUN AGAIN. THE USER MAY WANT TO 
INITIALIZE A FRESH VOLUME. TO DO THISs USE THE LCU SUBCOMMAND 
INITMV. T0 ADD A VOLUME TO THE NOS/VE SETs I.E. TO ALLOW NOS/VE 
USE OF THE VOLUME, USE THE LCU SUBCOMMAND ADDMTS. AN EXAMPLE IS 
SHOWN HERE. 


EXECUTELTASK TP=MANAGE_ LOGICAL. CONFIGUATION 
INITIALIZE_LMS_VOLUME ELEMENT=FMD40_B RECORDED _VSN="VSNCO2* 
ADDLMEMBER_TO_LSET MEMBER_VSN="VSNO002! 

QUIT 


DURING A NONINSTALLATION DEADSTARTs AN ATTEMPT WILL BE MADE TO 
BRING ALL LOGICALLY CONFIGURED VOLUMES ONLINE AND REACTIVATE 
THEM. THIS MEANS THE ABOVE SEQUENCE NEED ONLY OCCUR WHEN A NEW 
VOLUME ITS BEING BROUGHT ONLINE THE FIRST TIME. 


REFERENCE HAS BEEN MADE TO THE NOS/VE INSTALLATION COMMAND 
INTERFACE ERS.» TO GET A COPY OF THIS DOCUMENT ON S/N 1015 ENTER 
SES» MADeLISTNIH. 


“ell KDISPLAY_AscIl 


SUPPORT OF 6-12 ASCII FROM THE CONSOLE (K DISPLAY) CAUSES THE 
FOLLOWING CHANGES 


INPUT TRANSLATED. 10 INPUT IRANSLATED_I0 
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7{ C 


(SINGLE QUOTE) 


~~ 
i 
a ee Oe Ae 


‘4s 
JA TO /Z A= Z (LOWER CASE) 


NM Ow we ww HH 8 
~~ 
* 


~ CUNDERSCORE) 


4012 EDD_AND_OSDJ_INEGR MATION 


MOST OF THE STEPS LISTED HERE ARE USED TO GATHER INFORMATION 
FOR RECOVERY PROBLEMS» ETC. IF YOU ODO NOT WISH TO DO THIS» 
EXECUTE STEPS D AND E ONLY (EDD DUMP AND NOS LEVEL 3 DEADSTART). 


As 
Be 
C. 


De 


ENTER OR I AT THE MDD DISPLAY. 


ENTER HP AT THE MDD DISPLAY. 


IF IOU.FSi NOT = O OR IQU.FS2 NOT = 0 THEN DO NOT ENTER DU 
AT THE MDD DISPLAY ELSE DO ENTER DU AT THE MDD DISPLAY. 


PRESS DEADSTART BUTTON AND PERFORM EDD 


1) 
2) 
3) 
4) 
5) 
6) 


7) 
8) 


9) 


MOUNT SCRATCH TAPE (RING IN) ON A 9=TRACK DRIVE. 
PUSH D/S BUTTON. 
SELECT U (UTILITIES) DISPLAY. 
SELECT E (&0D) OISPLAY. 
SET CHANNEL (S2=13). 
SET ECUU ($2201UU) 
E = EQUIPMENT 

C = 1 FOR 67X DRIVES» 2 FOR 66X ORIVES 

UU = UNIT NUMBER OF THE TAPE DRIVE TO BE USED. 
ANSWER "DUMP NUMBER” WITH A CR. 
ANSWER "NON ZERQ INHIBITS REWIND" WITH A CR. 
ANSWER “CHANNEL CONTROLWARE™ WITH A CR. WARNING: IF 


THIS STEP IS OMITTEDs OSDI CANOT PROCESS THE DUMP 
TAPE. 
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E. PERFORM A LEVEL 3 NOS DEADSTART (SEE SECTION 4.14). 


Fe IF YOU ARE RUNNING ON THE $359 ENTER THE FOLLOWING AT THE 
CONSOLE 


X,DIS. 
USERsINT1sINT1X. 
GET» DMPDFS/UN=JLG. 
BEGIN» »sDMPDFS, 


DROP. 


THIS IS A PROCEDURE TO DUMP SEVERAL DAYFILES ASSOCIATED WITH 
THE NVEXXXX JOB AND ARE NEEDED ALONG WITH THE EDD TAPE TO 
ADEQUATELY DEBUG A NOS/VE HANG. 

SOME OF THE CRASHES THAT NOS/VE ENCOUNTERS WILL CAUSE NOS/VE 
TO TERMINATE SUCH THAT THE OPERATOR WILL NOTICE THE K=DISPLAY 
WHICH REQUESTS THAT A K.*RUN. BE ENTERED. BEFORE A Ke*RUN. IS 
ENTERED THE EDD SHOULD BE PERFORMED. 


TO CREATE A LISTING OF THE EDD TAPEs TYPE SESsINT1.-DSDI SEE 
THE PROCEOURE*S HELP DOCUMENTATION FOR PARAMETER DESCRIPTIONS. 


C170 OSDI INFORMATION CAN BE FOUND IN CHAPTER 10 OF THE NOS 
SYSTEM MAINTENANCE MANUAL. 


A170 OSOI INFO CAN BE FOUND IN DOCUMENT ARH3060 -~- GID FOR 
A170 NOS/S2. | 


4.13 NOS/VE_TERMINATION 


QO BRINGING DOWN DUAL STATE 


KeaNVE. 
K eTERMINATE_SYSTEM 


0 IF NOT A NORMAL TERMINATION 
K»aNVEe 
K.*RUN, 
Ke*ENDLST. 
Ke* ENDRUNS 


4014 A1ZO_NOS _ SHUTOOWN 


BEFORE LEAVING THE MACHINEs IT IS NECESSARY TO BRING NOS COWN. 
IF NOS HAS CRASHEDs A LEVEL 3 DEADSTART MUST BE ATTEMPTED EVEN IF 
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1) PUSH D/S BUTTON 
2) SELECT "0" DISPLAY 
3) SELECT ™P" DISPLAY 
4) ENTER I23 
5) ENTER (CR) 
6) ENTER DATE/TIME 
IF A DUMP IS DESIRED BUT A CRASH HAS NOT OCCURRED STEP. 
SHNULD ALWAYS BE ENTERED BEFORE PUSHING THE ODEAOSTART AUTTON. 
AFTER THE DUMP HAS BEEN TAKEN A LEVEL 3 DEADSTART SHOULD BE 
PERFORMED. 
TO BRING NOS DOWNs DO THE FOLLOWING 
1) ENTER 
CHE 
THE SCREEN WILL DISPLAY 


CHECK POINT SYSTEM. 
ENTER: CARRIAGE RETURN 


2) MAKE SURE NO MASS STORAGE DEVICE HAS A CHECKPOINT REQUESTED. 
TO O08 THIS» ENTER? EsM. IF THE DISPLAY SHOWS THERE ARE NO 
"C#S IN THE STATUS FIELDs THEN ALL DEVICES ARE CHECKPOINTED 
AND YOU MAY CONTINUE. 

3) ENTER 

STEP « 


4) PUSH DEADSTART BUTTON. 
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5e0 RECOVERY _OF_NOSZVE_ PERMANENT _ELLES 


Sel SETVYE_EORMAT 


THE GENERAL FORMAT OF THE SETVE COMMAND IS 


XeSETVE CPN=FFFF » UN=UN » VSN=V5N 9D=D »P =P 9 B=Bs C=C » CH=CH) 


FFFF IS A STRING OF NO MORE THAN FOUR CHARACTERS. SETVE 


UN 


APPENDS FFFF TO ‘NVE® TO CONSTRUCT THE NAME OF A 
PROCEDURE FILE WHICHs WHEN INVOKEDs WILL DEADSTART 
NOS/7VE. THE DEFAULT IS TST. 


SPECIFIES THE USER NUMBER FROM WHICH TPXXXK I5 
ATTACHED. UN IS THE FIRST CATALOG SEARCHED FOR OTHER 
FILES USED IN DEADSTARTING AND TERMINATING NOS/VE. THE 
DEFAULT IS INT. 


SPECIFIES THE DEADSTART COMMAND DECK TO BE USED WHEN 
DEADSTARTING NOS/VE. THE FUNCTION SERVED BY THE 
DEADSTART COMMAND DECK IS ANALOGOUS TO THE FUNCTION 
SERVED BY THE CMRDECK OF NOS. CURRENTLY SUPPORTED 
VALUES FOR C AND THEIR RESPECTIVE USES ARE 


1 ARDEN HILLS S3 S/N 02 OPEN SHOP/HANDS=-ON TIME 
3 ARDEN HILLS S3 S/N 02 CLOSED SHOP 

6 ARDEN HILLS $2 S/N 104 OPEN SHOP/HANDS<-ON TIME 
10 SUNNYVALE $32 CLOSED SHOP 


THE DEFAULT IS SET IN THE FILE CMDS1. CURRENTLY THE 
DEFAULT IS3 6.6 WARNING! SPECTEYING C=6_O0N_ THE ARDEN 
HILLS .53_WILL DESTROY THE NOS/VE PERMANENT FILE BASEs 


SPECIFIES AN ALTERNATE CATALOG TO BE SEARCHED FOR THE 
VARIOUS FILES USED IN DEADSTARTING AND TERMINATING 
NOS/VE. THE DEFAULT IS INTI. 


IS USED TO &INDICATE THAT THE SYSTEM CORE COMMAND 
PROCESSOR SHOULD ACCEPT COMMANDS FROM THE CONSOLE. 
SPECIFYING D=T IN THE SETVE COMMAND ALLOWS THE OPERATOR 
TO ENTER COMMANDS FROM THE CONSOLE AFTER PROCESSING THE 
DEADSTART COMMAND DECK. IF THE OPERATOR WISHES TO 
INITIALIZE THE SYSTEM DEVICE AND/OR INSTALL A NEW 
VERSTON OF NOS/VE»s D=T MUST BE SPECIFIED. THE DEFAULT 
IS SET IN THE FILE CMDS1. CURRENTLY THE DEFAULT IS 
D=F, 


SPECIFIES THE PASSWORD FOR THE CATALOG INDICATED BY THE 
UN PARAMETER. IF THIS PARAMETER IS OMITTED THE 
PASSWORD WILL BE GENERATED BY APPENDING AN *X*® J7O THE 
UN PARAMETER. 
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CH SPECIFIES THE OCTAL CHANNEL TO BE USED FOR NOS/VE DISK 
1/0. THE DEFAULT IS SET IN THE FILE CMDS1. CURRENTLY 
THE DEFAULT IS 2. 


VSN SPECIFIES THE VSN OF A ODEADSTART TAPE. IF THIS 
PARAMETER IS USED THEN NOS/VE WILL 8E DEADSTARTED FROM 
THE TAPE SPECIFIED. {FF IT 15 OMITTEDs THEN NOS/VE WILL 
BE DEADSTARTED FROM THE PERMANENT FILE TPXXXK. | 


5e2 SEIVE_USASE 


EARLIER VERSIONS OF NOS/VE REQUIRED THAT TWO SETVE COMMANDS BE 
ISSUED IF THE SYSTEM WAS TO BE INSTALLED AND SUBSEQUENTLY 
RECOVERED. THE CURRENT SYSTEM DOES NOT REQUIRE THIS. THE CNLY 
REASON FOR ISSUING TWO SETVE COMMANDS IS TO PROVIDE A DEADSTART 
PROCEDURE THAT DGES NOT REQUIRE /PERMIT OPERATOR INTERVENTION. 


IT SHOULD BE NOTED THAT ONCE THE SETVE COMMAND HAS BEEN 
ISSUED, IT NEED NOT BE ISSUED AGAIN UNLESSee. 


1) THERE IS A NEED TO CHANGE ONE OR MORE OF THE PARAMETERS 
SPECIFIED IN SETVE. 


2) THE COMMAND FILE» NVEFFFFs SENERATED BY THE SETVE COMMAND 
IS PURGED FROM THE SYSTEM. 


TWO EXAMPLES OF SETVE USAGE AND SUBSEQUENT NOS/VE DEADSTART 
ARE GIVEN BELOW. THE FIRST EXAMPLE SHOWS A “HANDS ON" USER 
WORKING WITH RECOVERY. THE SECOND ILLUSTRATES THESE CONCEPTS FOR 
A TYPICAL NOS/VE CLOSED SHOP. THIS WRITER HOPES THAT THE READER 
WILL FIND BOTH EXAMPLES USEFUL AND ILLUMINATING. 


T. A "HANDS ON" USER 


THE COMMAND FILE NVERSO IS BUILT AND INSTALLED IN NOS BY 
TYPING 


XsSETVE (RSDs UN=RS Ds VSN=TAPEs B=DEV1sC =65 D=T) 
SEVERAL OF THE CHOICES OF PARAMETERS ARE WORTH NOTING, 


1) BY SPECIFYING THE VSN PARAMETER THE USER HAS BUILT A 
COMMAND FILE THAT WILL DEADSTART THE SYSTEM OIRECTLY 
FROM THE TAPE PRODUCED BY NVESYS. 


2) THE USER IN THIS EXAMPLE HAS SPECIFIED DEADSTART 
COMMAND DECK 6 (C PARAMETER) AND HAS ALLOWED THE 
NOS/VE OISK 170 CHANNEL (CH PARAMETER) TO DEFAULT TC 
2e ONE CONCLUDES THAT THE USER IS RUNNING ON THE 
ARDEN HILLS S2- 
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3) THE USER HAS SPECIFIED D=T. THIS IS IMPORTANT. THE 

DEADSTART COMMAND WHICH TRIGGERS INSTALLATION OF A 
RECOVERABLE SYSTEM CANNOT BE READ FROM A ODEADSTART 
COMMAND DECK. IT MUST BE ENTERED FROM THE CONSOLE AT 
DEADSTART TIME. SPECIFYING D=T ALLOWS THE OPERATOR 
TO ENTER COMMANDS FROM THE CONSOLE. 
NOS/VE IS DEADSTARTED BY TYPING 
NVERSD. 
AT THE CONSOLE. 
THE USER BRINGS UP THE K DISPLAY BY TYPING 
K»NVE. 

PRESENTLY» THE DEADSTART COMMAND DECK IS DISPLAYED AND 
THE USER IS PROMPTED FOR INPUT.» THE DEADSTART COMMAND DECK 
USED IN THIS EXAMPLE LOOKS LIKE THIS 
SETLSYSTEM_ATTRIBUTE HALTRING 15 
ENAP 
USE_CONFIGURATION PROLOG S25N104_ DEVELOPMENT 
USELINITIALIZATION PROLOG EMPTY | 
SETL-DEADSTART_CONTROLLER $7155_1 
SET_DEADSTART_DEVICE $885.12 41(8) 

THE USER TYPES 


Ke INITDD VSNOO1. 
K.GO-~ 


THE SYSTEM ACCEPTS THE COMMANDS AND INSTALLS AND 
DEADSTARTS NOS/VE. 


AFTER THE SYSTEM COMES DOWN» VIA EITHER CONTROLLED 
TERMINATION GR A CRASH» THE SYSTEM CAN BE RECOVERED (IF 
NECESSARY) AND REDEADSTARTED BY TYPING 
NVERSD. 


WHEN THE DEADSTART COMMAND DECK IS DISPLAYEDs THE USER 
TYPES 


K.GO. 


THIS WILL CAUSE NOS/VE TO BE DEADSTARTED WITHOUT 
INITIALIZING THE SYSTEM DEVICE. 


A TYPICAL "CLOSED SHOP" 
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TWO COMMAND FILES» NVECLSH AND NVEINST» ARE CREATED BY 
TYPING 


X¥. SETVE(CLSH»sUN=CLSHsB=DEV1sC=10sCH=1) 
Xe SETVECINSTsUN=CLSHs B=DEV1»C=#=10s CH=1sD=T) 


ONE NOTES THAT 


1) CLOSED SHOP IS DEADSTARTED FROM A TPXXXK FILE IN THE 
CLSH CATALOG. 


2) SPECIFYING D=Ts FOR NVEINSTs CAUSES DEADSTART TO 
PAUSE FOR OPERATOR INTERVENTION’ | 


A NORMAL DEADSTART IS USED WHEN BRINGING UP NOS/VE AT 
THE BEGINNING OF CLOSED SHOP GR FOLLOWING A SYSTEM FAILURE, 
THE OPERATOR» IN THIS EXAMPLE» TYPES 
NVECLSH. 

NOS/VE WILL RECOVER CIF NECESSARY) AND DEADSTART. WHEN 
RECOVERY RUNS» THE OPERATOR MAY BE REQUIRED TO RESPOND TO A 
REQUEST FOR INPUT FROM THE MANLC UTILITY. SEE NOTE 4 AT 
THE END OF THIS SECTION FOR MORE INFORMATION. 


IF IT IS NECESSARY TO REINITIALIZE THE SYSTEM ODEVICE>s 
THE OPERATOR KEYS 


NVEINST. 


THIS CAUSES DEADSTART TO PAUSE AND WAIT FOR OPERATOR 
INPUT WHEN DEADSTART COMMANDS ARE BEING PROCESSED. 


THIS AMOUNTS TO AN INSTALLATION DEADSTART. THIS SHOULD 
BE USED ONLY WITH FULL KNOWLEDGE THAT ANY FILES WHICH MAY 
HAVE EXISTED ON MASS STORAGE PRIOR TO THIS DEADSTARTs» WILL 
BE_BLASTED_INIO_OBLIVION.8Y_IT. 

AN INSTALLATION DEADSTART WILL BE REQUIRED IF 


1) THIS IS THE INITIAL INSTALLATION OF A RECOVERABLE 
VERSION OF NOS/VE. 


2) IF THE FILE SYSTEMS OF THE SYSTEM BEING INSTALLED AND 
THE SYSTEM BEING SUPERCEDED ARE NOT COMPATIBLE. 


3) IF THE FILE SYSTEM HAS BEEN DAMAGED BEYOND THE 
POSSIBILITY CF RECOVERY. 


AN INSTALLATION DEADSTART IS EFFECTED BY TYPING 
Ke INITDD VSNOO1. 
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WHEN THE DEADSTART COMMAND ODECK IS OISPLAYED AND THE 
DPERATOR IS PROMPTED FOR INPUT, 


NOTES 


: 


3e 


4 


THE CMDS1 FILE USED TO DEADSTART NOS/VE MUST HAVE THE 
DEBUG2 FLAG SET TO TRUE. WHEN NOS/VE IS DEADSTARTEDs 
THE CATALOG SPECIFIED BY THE UN PARAMETER IS FIRST IN 
THE SEARCH ORDER FOR CMDS1» FOLLOWED BY THE CATALOG 
SPECIFIED BY THE B PARAMETER. 


SEE SECTION 303 OF THE INTEGRATION PROCEDURES 
NOTEBOOK FOR OTHER INFORMATION ABOUT THE CMDS1 FILE. 


IF NOS/VE CRASHES AND A ODUMP IS DESIRED (IN THE 
CONTEXT GF OUR SECOND EXAMPLE) 


Ie TYPE DU AT THE MDD CONSOLE. THE MESSAGE 
"WRITING IMAGE FILE"*® SHOULD APPEAR IMMEDIATELY. 
THE MESSAGE “IMAGE FILE COMPLETE" SHOULD APPEAR 
A FEW MOMENTS LATER. 


II. PUSH THE DEADSTART BUTTON. 
III. TAKE THE EDD DUMP, 
IV. DO A LEVEL 3 NOS DEADSTART. 
ALTERNATIVELY THE OPERATOR CAN SKIP STEP I IF 
SHE/HE IS SURE TO REDEADSTART NOS/VE AFTER STEP IV. 
IN THIS EVENT THE SYSTEM WILL DETECT THAT THE IMAGE 


FILE WAS NEVER CREATEDs WEILL CREATE ONEs AND WILL 
RECOVER FROM IT. 


A RECOVERY DEADSTART WHICH IS UNDER THE CONTROL OF A. 


SETVE COMMAND IN WHICH D=T WAS SPECIFIED WILL PAUSE 
IN THE RECOVERY SYSTEM WITH THE MESSAGE “OPERATOR 
INTERVENTION BEFORE RECOVERY BEGINS". THE SYSTEM IS 
EXECUTING THE LOGICAL CONFIGURATION UTILITY AT THIS 
POINT. IN ORDER TO EXIT THIS UTILITY AND ALLOW 
RECOVERY TO PROCEED THE OPERATOR TYPES K.QUIT (NO 
PERTOD).» FOR MORE DETAILS ON THE USE OF THE LCU SEE 
SECTION 4.9 OF THIS DOCUMENT AND THE NOS/VE 
INSTALLATION COMMAND INTERFACE ERS. 


503 AIGRATING EROM_ LEVEL _N_TO_LEVEL Ntls_ INSTALLING J08_ TENPLATES 


THE READER IS STRONGLY ADVISED TO READ THIS ENTIRE PROCEDURE 
BEFORE SEGINNING IT. 
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USING NVELINKs LINK THE SYSTEM JOB TEMPLATES. 

THE OUTPUT FROM THE LINKER IS TWO MASS STORAGE FILES 
CALLED PJBXXYY AND RJBXXYY. THESE 2 FILES NEED TC BE 
REFORMATTED INTO THE FORMAT USED IN BRINGING UP NOS/VE. 
THIS REFORMATTING IS ACCOMPLISHED BY THE BLDJTMP PROCEDURES 
WHICH IS INVOKED AS FOLLOWS 
SESsINT1LeBLDJTMP JTF2FILE1 NSTF=FILE2 


WHERE FILEL = EITHER PJBXXYY OR RJBXXYY AND FILE2 = THE NEW 
NAME FOR THE REFORMATTED VERSION OF THE JOB TEMPLATE. 


THIS PROCEDURE WILL BE USED ONCE FOR EACH TEMPLATE. 

EXAMPLE 
SESsINT1LeBLDJTMP JTF2PJBXXYY NJTF=PRO 
SESsINTL.BLOJTMP JTF2RIBXXYY NJTF2REC 

WHEN BOTH OF THESE CALLS ARE COMPLETE THE FILES PRO AND 
REC WILL BE IN THE USER'S CATALOG. : 
DUMP THE REFORMATTED FILES (PRO AND REC IN THE EXAMPLE) TO 
TAPEs AND RELOAD THE FILES ON A 170 CATALOG ON THE TARGET 
MACHINE. : 
BRING UP LEVEL N OF NOS/VE. 

NOTEs SINCE THE COMMANDS TO INSTALL THE NEW SET OF JOB 
TEMPLATES MUSI BE ISSUED BY THE CPERATORs ALL COMMANDS 
SHOWN HERE ARE ASSUMED TO 8& ISSUED FROM THE SYSTEM 
CONSOLE. 


00 A GETF ON EACH OF THE LOADED FILES SPECIFYING B60 
CONVERSION. 


EXAMPLE: (ASSUME PRO AND REC ARE IN THE 170 CATALOG.) 


GETF TO=PTEMPL FROM=PRO DC=36060 
GETF TO=RTEMPL FROM=REC DC=B606 


WHERE PTEMPL AND RTEMPL ARE 180 LOCAL FILE NAMES. 
AFTER BOTH FILES ARE LOCAL» DO (FOR EACH TEMPLATE) 
CONJT (LOCAL FILE NAME) 
THIS COMMAND WILL CONVERT THE TEMPLATE TO 180 FORMAT (60 


- 64 BIT CONVERSION). THIS COMMAND IS RESTRICTED TC THE 
OPERATOR JOB (2.E-« SYSTEM CONSOLE). 
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CONTINUING IHE_EXAMPLE 


CONJT PTEMPL 
CONST RTEMPL 


CREATE THE ACTUAL JOB TEMPLATE FILE BY ENTERING 

CREJT TN=( TEMPLATE NAME) FN=(FILE NAME) 

WHERE (TEMPLATE NAME) IS THE NAME OF THE JOB TEMPLATE FILE 
BEING INSTALLED ON THE SYSTEM.» THIS IS THE NAME THAT WILL 
BE USED TO IDENTIFY THE JOB TEMPLATE DURING FUTURE 
DEADSTARTS. (FILE NAME) IS THE NAME OF THE CONVERTED JOB 
TEMPLATE FILE. 

NOTE: BEFORE USING THIS COMMAND DISPLAY THE JOB LOG (VED 
JL) AND CHECK THAT THE JMPSLOAD_LJOBLTEMPLATE TASK COMPLETES 
BEFORE ATTEMPTING ANOTHER CREJT COMMAND OR GOING TQ THE 
NEXT STEP. 

CONTINUING. THE EXAMPLE 


VED JL 
CREJT TN=P10 FN=PTEMPL 


CHECK FOR TASK COMPLETION 

CREJT TN=R10 FN=RTEMPL 

CHECK FOR TASK COMPLETION 

TAKE NOS/VE DOWN AND RECOVER THE LEVEL N SYSTEM. PERFORM A 
CONTINUATION DEADSTART USING THE DEADSTART (TPXXXK) TAPE 
FOR THE LEVEL N+#1 SYSTEM. 


WHEN THE SYSTEM IS WAITING FOR OPERATOR INTERVENTIONs IN 
ADDITION TG ANY OTHER COMMANDS» DO 


USE_LSYSTEM_JOBL TEMPLATE (TEMPLATE NAME) OR 
USESJT (TEMPLATE NAME) 


WHERE (TEMPLATE NAME) IS THE NAME USED ON THE CREJT 
COMMAND. 


CONTINUING. THE EXAMPLE 
USE_LSYSTEM_JOB_LTEMPLATE P10 
LET DEADSTART PROCEED. 


TF A CRASH OCCURS DR A RECOVERY IS NECESSARY, WHEN THE 
RECOVERY SYSTEM IS WAITING FOR OPERATOR COMMANDS» TYPE 
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USELRECOVERY_JOBLTEMPLATE (TEMPLATE NAME) OR 
USERJT (TEMPLATE NAME) 


WHERE (TEMPLATE NAME) IS THE NAME USED ON THE CREJT 
COMMAND. 


CONTINUING. THE EXAMPLE 
USELRECOVERY_JOBLTEMPLATE R190 


AS AN ALTERNATE TO TYPING IN THE USE .2. JOB TEMPLATE 
COMMANDSs A DEADSTART COMMAND FILE (DCFILE) CAN BE CREATED 
SPECIFYING BOTH THE USESJT XX AND USERJT YY COMMANDS IN THE 
FILE IN ADDITION TO OTHER COMMANDS.» AGAIN» XX IS THE NAME 
USED FOR THE TN PARAMETER ON THE CREJT COMMAND FOR THE 
SYSTEM JOB TEMPLATE AND YY IS THE NAME USED FOR THE TN 
PARAMETER ON THE CREJT COMMAND FOR THE RECOVERY JO8 
TEMPLATE. : 


TO REMOVE OLD JOB TEMPLATES USE THE COMMAND 
DELETE_JOBLTEMPLATE (TEMPLATE NAME) OR ODELJT (TEMPLATE 
NAME) WHERE (TEMPLATE NAME) IS THE NAME SPECIFIED ON THE 
CREJT COMMAND. 
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600 SYSTEM_CORE DEBUGGER 


THE SYSTEM CORE DEBUGGER PROVIDES A SET OF CAPABILITIES 
INTENDED TO ASSIST IN DEBUGGING THE OPERATING SYSTEM. SERVICES 
PROVIDED BY THE DEBUGGER ARE TASK ORIENTED? SELECTION CF THE 
TASKS TO BE DEBUGGED MUST BE MADE VIA DEBUGGER SUBCOMMANDS. NO 
TASKS WILL BE UNDER CONTROL OF THE DEBUGGER UNLESS THEY ARE 
SELECTED. THE SELECTION CAPABILITY ALLOWS ANY NUMBER OF TASKS TO 
BE DEBUGGED SIMULTANEOQUSLY$ FROM ONE TASK TO ALL TASKS IN THE 
SYSTEM. OBVIOUSLY <A CAPABILITY THIS POWERFUL MUST BE USED WITH 
SOME CARE. THE SYSTEM CORE DEBUGGER USES THE DEBUG HARDWARE TO 
PROVIDE THESE CAPABILITIES. 


6e1 SYSQERUG 

THE PURPOSE OF THIS COMMAND IS TO INITIATE EXECUTION OF THE 
SYSTEM CORE DEBUGGER, THIS CGMMAND CAN BE ISSUED FROM THE 
DEADSTART COMMAND FILE OR AS A COMMAND IN ANY JOB. 
SYSDEBUG 


THIS COMMAND HAS NO PARAMETERS 3 ALL INFORMATION THE DEBUEECER 
REQUIRES IS PROVIDED VIA SUBCOMMANDS. 


THE SYSTEM CORE DEBUGGER CAN ALSO BE INVOKED FROM THE MDD 
CONSOLE. THE FORMAT OF THE COMMAND [5S 


DD NeSYSDEBUG 


WHERE N IS THE JOB ORDINAL OF THE DESIRED JOB. THE DEBUGGER IS 
BROUGHT UP IN THE JO8 MONITOR TASK OF THE JOB. ALL SYSTEM CORE 
DEBUGGER SUBCOMMANDS ARE AVAILABLEs BUT MUST BE PREFIXED BY THE 
MDD COMMAND DO. 


THE SYSTEM CORE DEBUGCER CAN ALSO BE BROUGHT UP (FROM THE MDD 
CONSOLE) BY SPECIFYING A GLOBAL TASK ID. THE FORMAT OF THE 
COMMAND IS 
DD NeTOEBUG GGGGGG 
THE VALUE OF N IS IGNORED» AND THE VALUE GG6GGGG SPECIFIES THE 
NOS/VE GLOBAL TASK I0 (3 HEX BYTES) OF THE TASK TO BRING THE 
DEBUGGER UP IN. IF THE TASK ID IS INVALIDs THEN THE COMMAND WILL 
BE IGNORED. 

602 SUBCOMNAND PARAMETER DEFINITIONS 
<N AM E> 
<CONDITIOND %8= READIWRITELRNIITBRANCHICALLIDIVFLTLARLOS1 
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AROVFLLEXOVFLIEXUNFLIFPLOSIFPINDEF 1INVBDP 
<BASE> é 
<OFFSET> t22= INTEGER 
<LENGTH> 222 INTEGER 
<COUNT>D %3= 14210006 
<REGIDD 32 X1LALP 
<REGNOD 232 6,..1510..0F(16) 
<VALUE> tt= INTEGER 
<TIMED 
LVSTRINGD %32 tCHARSTRING? 
CDATATYPE> 3222 HEXLASCIIUASCIDEC 
<CHANGE_COUNT> st= 1.28 
<SELECTORD s3= FULLIAUTOISAVE 
6e3 SYSTEM_CORE_ DEBUGGER SUBCOMMANDS 


WITHIN THE DESCRIPTIONS WHICH FOLLOWs OPTIONAL PARAMETERS ARE 
ENCLOSED IN BRACKETS. OEFAULT VALUES FOR OPTIONAL PARAMETERS ARE 
ALSO DEFINED. 


Sbe301 SELECT 


THE PURPOSE OF THIS SUBCOMMAND IS TO SELECT THE TASKS IN WHICH 
THE SYSTEM CORE DEBUGGER IS TO BE ACTIVE. WHEN THE DEBUGGER IS 
FIRST CALLED» IT IS NOT ACTIVE IN ANY TASK. TO USE THE DEBUGGER 
THEREFOREs IT IS NECESSARY TO SELECT THE TASKS IN WHICH IT IS TO 
BE ACTIVE. 


SELECT <SELECTION OPTION> C<RING NUMBER> 1 <ACTIVE JOB LIST 
ORDINAL> 1 


SELECTIONLOPTION: THIS PARAMETER SPECIFIES ONE OF A SERIES OF 
SELECTION OPTIONS USED TO CONTROL THE TASKS IN WHICH THE DEBUGGER 
WILL BE ACTIVE AND SOME OTHER DEBUG OPTIONS.» THE SELECTIONS ARE 
REMAIN IN EFFECT UNTIL THEY ARE EXPLICITLY CHANGED WITH 
SUBSEQUENT SELECT SUBCOMMANDS. VALID SELECTION OPTIONS ARE 


<RIGHTILEFT> - THIS SELECTS THE SCREEN FOR THE DEBUG 
DISPLAY. THE CISPLAY STAYS ACTIVE WHEN THE SCREEN IS 
SWITCHED. 

<JOBMONITORINOJOBMONITOR> - THIS SELECTS WHETHER OR NOT 


TO DEBUG JOB MONITOR TASKS. 


<USERINOUSER> — THIS SELECTS WHETHER OR NOT TO DEBUG USER 
TASKS (IeE&. THOSE THAT ARE NOT JOB MONITORS). 


<HIGHRING> = THIS SPECIFIES THE HIGHEST RING IN WHICH 


DESUG TRAPS WILL BE RECOGNIZED. TRAPS OCCURRING IN) RINGS 
ABOVE THIS SELECTICON WILL BE IGNORED. 
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<JOBINOJOB> = THIS ENABLES OR DISABLES DEBUGGING FOR THE 
J08 AT THE SPECIFIED ACTIVE JOB LIST ORDINAL.»~ THE SYSTEM 
JOB HAS AN ACTIVE JOB LIST ORDINAL OF ZERO. 


<ALLJOBSINOJOBS> - THIS ACTIVATES OR DEACTIVATES 
DEBUGGING IN ALL JOBS. 


THE INITIAL SELECTIONS ARE RIGHT» NOSTEPs NOJOBMONITORs 
NOUSER»s HIGHRING=35 NOJOGBS. 


60302 BREAKPOINT 1 8B 


THE PURPOSE OF THIS SUBCOMMAND IS TO SELECT A PROGRAM 
INTERRUPT WHICH IS TO TAKE PLACE UPON OCCURRENCE OF A SPECIFIED 
CONDITION WITHIN A SPECIFIED VIRTUAL ADDRESS RANGE. 


BREAKPOINT <NAME> <CONDITIOND (<BASE>] C<OFFSET>] C<LENGTHD>] 


THE <NAME> IS ANY USER SUPPLIED NAME FOR IDENTIFYING THE 
BREAKPOINT. A MAXIMUM OF THIRTY TWO BREAKPOINTS CAN BE SELECTED. 
WHEN A TRAP OCCURS» THE <NAME> OF THE BREAKPOINT WHICH CAUSED THE 
TRAP IS DISPLAYED. 


THE BASE PARAMETER IS REQUIRED WHEN SPECIFYING A NEW 
BREAKPOINT NAME$ OFFSET AND LENGTH SPECIFICATIONS ARE OPTIONAL IN 
THIS CASE. WHEN ADDING A NEW CONDITION SELECTION TO AN EXISTING 
BREAKPOINT» BASE» OFFSETs AND LENGTH PARAMETERS MAY NOT BE 
SPECIFIED. 


BASEs OFFSET» AND LENGTH PARAMETERS DEFINE THE DESIRED VIRTUAL 
ADDRESS RANGE!t <BASE> + <OFFSET> YIELDS A FIRST-BYTE-ADDRESS 3 
FIRST=BYTE-ADDRESS + <LENGTH> -1 YIELDS A LAST BYTE ADDRESS. 

DEFAULT PARAMETER VALUES 
<OFFSET>: 90 
<LENGTH>? 1 
60323 REMOVE BREAKPOINT 1 RB 

THE PURPOSE OF THIS SUBCOMMAND IS TO DESELECT A PREVIOUSLY 
SELECTED PROGRAM INTERRUPT. 

REMOVE. BREAKPOINT <NAMED C<XCONDITIOND] 

IF ONLY THE NAME PARAMETER IS SPECIFIEDs ALL CONDITIONS 
ASSOCIATED WITH THE BREAKPOINT ARE DESELECTED AND ALL EVIDENCE OF 
THE BREAKPOINT IS REMOVED. IF THE CONDITION PARAMETER [15 
SPECIFIEDs ONLY THAT CONDITION IS DESELECTED$ HOWEVER» IF THE 
SPECIFIED CONDITION IS THE ONLY CONDITION SELECTED» ALL EVIDENCE 
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OF THE NAMED BREAKPOINT IS REMOVED. 

THE PURPOSE OF THIS SUBCOMMAND IS TG PROVIDE A LIST OCF 
CURRENTLY SELECTED BREAKPDINTS AND ASSOCIATED CONDITIONS, 

LIST BREAKPOINT [€<NAME>] 

IF THE NAME PARAMETER IS SPECIFIEDs INFORMATION IS DISPLAYED 
FOR THE NAMED BREAKPOINT ONLY. IF THE NAME PARAMETER I5 NOT 
SPECIFIED, INFORMATION IS DISPLAYED FOR ALL CURRENTLY DEFINED 
BREAKPOINTS .« - 

62.325 CHANGE_BREAKPOINT 1 CB 

THE PURPOSE OF THIS SUBCOMMAND IS TO CHANGE THE VIRTUAL 
ADDRESS RANGE OF A PREVIQUSLY SPECIFIED BREAKPOINT. 

CHANGE _ BREAKPOINT <NAMED <BASE> (C<OFFSETS] C<LENGTHD] 

BASE» OFFSET» AND LENGTH PARAMETERS DEFINE THE DESIRED VIRTUAL 
ADDRESS RANGE? <BASE> + <OFFSET> YIELDS A FIRST-BYTE-ADDRESS3 
FIRST-BYTE=-ADDRESS + <LENGTH> -1 YIELDS A LAST BYTE ADDRESS. 

DEFAULT PARAMETER VALUES 
<OFFSET>! 0 . 

C<LENGTH>? 1 
5.3.6 TRACE BACK 1 T8 


THE PURPOSE OF THIS SUBCOMMAND IS TQ PROVIDE INFORMATION 
RELEVANT TO STACK FRAMES ASSOCIATED WITH AN INTERRUPTED PROCEDURE 
AND ITS PREDECESSOR PROCEDURES. VALIDATION OF PVA*S IS NOW 
PERFORMED. 


INFORMATION DISPLAYED FOR EACH SELECTED STACK FRAME CONSISTS 
oF | 


~ STACK FRAME NUMBERS 
~ CURRENT P-ADDRESS OF THE ASSOCIATED PROCEDURE; 
~ VIRTUAL ADDRESS OF THE START OF THE STACK FRAME} 
~ VIRTUAL ADDRESS OF THE STACK FRAME SAVE AREAs 
TRACEBACK C<FRAME>] C<XCOUNT>] CFULLISHORT) CPVA 
CYCLE ll» JANUARY 1983 


6-5 
NOS/VE CYCLE 11 HELPFUL HINTS 
| 83/03/11 


THE FRAME PARAMETER SPECIFIES THE NUMBER OF THE FIRST STACK 
FRAME FOR WHICH INFORMATION IS TO BE DISPLAYED. STACK FRAME 
NUMBER ONE IS ASSOCIATED WITH THE INTERRUPTED PROCEDUREs STACK 
FRAME Two IS ASSOCIATED WITH THE INTERRUPTED PROCEDURE'S 
PREDECESSOR» ETC. 


THE MODULE NAME PROVIDED ON THE TRACEBACK be USUALLY CORRECT 
BUT NOT GUARANTEED. 


THE COUNT PARAMETER SPECIFIES THE TOTAL NUMBER OF STACK FRAMES 
FOR WHICH INFORMATION IS TO BE DISPLAYED. 


THE PVA PARAMETER SPECIFIES A STACK FRAME PVA TO BEGIN THE 
TRACEBACK. THIS IS USEFUL WHEN A STACK IS VERY LARGE AND YOU 
WISH TO DISPLAY IT RANDOMLY. 


DEFAULT PARAMETER VALUES 


<FRAMED3 1 
<COUNT>? 1 


603-7 DISPLAYLSTACK_FRAME 1 DSF 


THE PURPOSE OF THIS SUBCOMMAND IS T0Q DISPLAY SELECTED 
INFORMATION FROM A SPECIFIED STACK FRAME. 


DISPLAY_STACK_FRAME [C<FRAME>] C<SELECTORD] 


THE FRAME PARAMETER SPECIFIES THE NUMBER OF THE STACK FRAME 
FOR WHICH INFORMATION IS TO BE DISPLAYED. (STACK FRAME NUMBER 
ONE 1S ASSOCIATED WITH THE INTERRUPTED PROCEDURE» STACK FRAME TWO 
IS ASSOCIATED WITH THE INTERRUPTED PROCEDURE'S PREDECESSOR» ETC.) 


THE SELECTOR PARAMETER IDENTIFIES A REGION OF THE SPECIFIED 

STACK FRAME | 

AUTOs CAUSES THE AUTOMATIC REGION OF THE STACK FRAME TC BE 
DISPLAYED. 

SAVE CAUSES THE SAVE AREA OF THE STACK FRAME TO BE DISPLAYED. 

FULL: CAUSES BOTH THE AUTOMATIC AND SAVE AREAS OF THE STACK 
FRAME TO BE DISPLAYED. 


DEFAULT PARAMETER VALUES 


<FRAME>D3 1 
<SELECTOR>: FULL 
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623.8 DISPLAY_REGISTER 1 DOR 
THE PURPOSE OF THIS SUBCOMMAND IS TO DISPLAY THE CONTENTS OF A 
SPECIFIED REGISTER OF AN INTERRUPTED PROCEDURE, 
DISPLAY_REGISTER <REGIO> (C<REGNO>] C<DATATYPE>D] 
DEFAULT PARAMETER VALUES 
€REGNOD: O 
<DATATYPE>?: HEX 
60309 DISPLAY MEMORY 1 DM 


THE PURPOSE OF THIS SUBCOMMAND IS TOG DISPLAY THE CONTENTS OF A 
SPECIFIED AREA OF VIRTUAL MEMORY. VALIDATION OF PVA'S IS NOW 
PERFORMED. 

DISPLAY_MEMORY <BASE> C<XLENGTH>] [FIN 

THE FIN PARAMETER ALLOWS YOU TQ FORCE (F) MEMORY TO BE 
DISPLAYED EVEN IF IT IS BEYOND THE CURRENT SEGMENT LENGTH. THE 
DEFAULT IS NOT TO FORCE (N) THE DISPLAY. 

DEFAULT PARAMETER VALUES 


<LENGTH>: 8 
6.3.10 CHANGE_LMEMDRY 1 CM 


THE PURPOSE OF THIS SUBCOMMAND IS TO SET A SPECIFIED VALUE 
INTO A SPECIFIED LOCATION OF VIRTUAL MEMORY FOR A_ SPECIFIED 
NUMBER OF BYTES.» VALIDATION GF PVA*S IS NOW PERFORMED, 

CHANGE_MEMORY <BASE> <VALUE> <CHANGE _COUNT> 

DEFAULT PARAMETER VALUES 


<CHANGE_COUNT>?: 1 
623211 RUN 


- THE PURPOSE OF THIS SUBCOMMAND IS TO INVOKE PROGRAM EXECUTION 
AFTER A SELECTED PROGRAM INTERRUPT HAS OCCURRED. 
RUN 
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6.3.12 SUPER_CHANGE_MEMORY 1 SCM 


THE PURPOSE OF THIS SUBCOMMAND IS THE SAME AS THE CHANGE 
MEMORY SUBCOMMANDs THAT IS,» TO CHANGE THE CONTENTS OF VIRTUAL 
MEMORY.» IT DIFFERS FROM CHANGE MEMORY» HOWEVERs IN THAT IT WILL 
CHANGE THE ATTRIBUTES OF THE SEGMENT TO ALLOW MEMORY TC BE 
WRITTENs AND THEN CHANGE THE ATTRIBUTES BACK TO THEIR GRIGINAL 
VALUES. 


THE COMMAND FORMAT IS THE SAME AS THE CHANGE MEMORY 
SUBCOMMAND. 


623213 FORMAT i FMT 


THE PURPOSE OF THIS SUBCOMMAND IS TO SET THE SYSTEM CORE 
DEBUGGER INTO A MODE WHERE ALL SUBCOMMAND QUTPUT IS SENT TO A 
LOCAL FILE WHICH IS PRINTED (PRIF) WHEN THE UNFMT SUBCOMMAND IS 
ENTERED. THIS IS DONE BY HAVING THE TASK RUNNING THE DEBUGGER 
COMMUNICATE WITH ANOTHER TASK RUNNING IN THE SYSTEM JOB. It I$ 
THIS OTHER TASK THAT ACTUALLY WRITES AND PRINTS THE FILE. THE 
ENTRY POINT OF THIS TASK IS OSPSBROKEN_ JOB_DUMP_TASK. IT) WILL 
NORMALLY BE INITIATED BY THE DS PROCEDURE. IF IT IS NOT RUNNING». 
A DIAGNOSTIC WILL BE ISSUED. THE PARAMETER TO THIS COMMAND IS A 
STRING WHICH WILL BE OUTPUT AS THE FIRST LINE OF THE FILE. 


COMMAND FORMAT 


FORMAT STRING 
623214 UNFORMAT 1 UNFEMT 

THE PURPOSE OF THIS SUBCOMMAND IS TO LEAVE THE OUTPUT MODE 
ESTABLISHED BY THE FORMAT COMMAND. OUTPUT WILL AGAIN BE SENT TO 
THE OPERATOR CONSOLE. AT THIS POINT THE PERMANENT FILE WILL BE 
FLUSHED TO MASS STORAGE. 

COMMAND FORMAT 

UN FORMAT 
663.15 DISPLAY_MONITOR FAULT 1 DISMF 

THE PURPOSE OF THIS SUBCOMMAND IS TO DISPLAY ANY MONITOR 
FAULTS PRESENT IN THIS TASK. SEE THE SECTION TITLED "NCS/VE 
PROCESSING OF JOB MODE SOFTWARE ERRORS* FOR MORE INFORMATION. 


ALL MONITOR FAULT BUFFERS ARE DISPLAYED IN THE HOPE THEY WILL 
SHOW SOME TASK HISTORY. IF A GIVEN FAULT BUFFER IS INVALIO THE 
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MESSAGE “FOLLOWING FAULT IS NOT PRESENT® IS DISPLAYED. 

COMMAND FORMAT 

DISPLAY MONITOR FAULT 
603216 DISPLAY_XCB 1 DISXCB 

THE PURPOSE OF THIS SUBCOMMAND IS TO DISPLAY ALL OF THE FIELDS 
OF THE CURRENT TASK*S (I-4Ees THE TASK RUNNING THE DEBUGGER) 
EXECUTION CONTROL BLOCK. 
603217 DISPLAY_TASKLU ENVIRONMENT 1 DISTE 

THE PURPOSE OF THIS SUBCOMMAND IS TO DISPLAY THE xXCB OF ALL 
TASKS RUNNING WITHIN THE CURRENT JOB (21.2Ees THE JOB WITH THE TASK 
RUNNING THE DEBUGGER). IF THE COMMAND IS ENTERED WHILE THE 
DEBUGGER IS IN FORMAT MODE» THEN A FULL XCB IS OISPLAYEDs 
OTHERWISE JUST THE TASK NAMEs XCB ADDRESS AND GLOBAL TASK ID ARE 
DISPLAYED. 
6.3.18 + 

THE PURPOSE QF THIS SUBCOMMAND IS TO INCREMENT THE LAST DM 
COMMAND ADDRESS BY THE LAST DM COMMAND COUNT AND EXECUTE THE 
RESULTING DM COMMAND. THERE ARE NO PARAMETERS TO THIS COMMAND. 
be 3.19 oe 

THE PURPOSE OF THIS SUSCOMMAND IS TO DECREMENT THE LAST DM 
COMMAND ADDRESS BY THE LAST DM COMMAND COUNT AND EXECUTE THE 
RESULTING DM COMMAND. THERE ARE NO PARAMETERS TQ THIS COMMAND. 
663220 DISPLAY_AUTO_COMMAND_LIST 1 DISACL 

THE PURPOSE OF THIS SUBCOMMAND IS TO DISPLAY ALL DEBUGGER 
COMMANDS THAT WILL BE EXECUTED DURING AN AUTOMATIC DUMP. THERE 
ARE NO PARAMETERS TO THIS COMMAND. 
62.3221 SETLAUTO_COMMAND_LIST 1 SETACL 

THE PURPOSE OF THIS SUBCOMMAND IS TOG CHANGE OR ADD A COMMAND 
TO THE AUTOMATIC DUMP COMMAND LIST. THE AUTOMATIC DUMP EXECUTES 
COMMANDS FROM THE START OF THE LIST UNTIL IT ENCOUNTERS A BLANK 
(EMPTY) COMMAND. 

COMMAND FORMAT 
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SETACL N "STRING* 

THE N PARAMETER SPECIFIES WHICH COMMAND IS TO BE CHANGED» 
STARTING WITH 1. THE STRING PARAMETER (CENCLOSED IN QUCTES) 
SPECIFIES THE COMMAND TO BE PLACED IN POSITION Ne 
6032.22 DISPLAY_SYSTEM_LOG 1 DISSL 

THE PURPOSE OF THIS COMMAND IS TO DISPLAY THE SEGMENT NUMBER 
AND CURRENT LENGTH OF A SYSTEM LOG. 

COMMAND FORMAT 

DISSL LOG START LEN 

THE LOG PARAMETER SPECIFIES WHICH LOG TO DISPLAY» AND MAY BE 
ONE OF: SYSTEMs STATS» ENGs ACCOUNT. IF LOG IS SYSTEMs THEN THE 
START AND LEN PARAMETERS ARE INTERPRETED AS FOLLOWS. 


THE START PARAMETER SPECIFIES THE FIRST BYTE OF THE LOG 
SEGMENT TO DISPLAY (QNLY FOR SYSTEM LOG). 


THE LEN PARAMETER SPECIFIES THE NUMBER OF BYTES TO DISPLAY 
(ONLY FOR SYSTEM LOB). 


6232.23 DISPLAY_JOB_LOGG 1 DISJL 

THE PURPOSE OF THIS COMMAND IS TO DISPLAY THE SEGMENT NUMBER 
AND CURRENT LENGTH OF A J08 LOG. 

COMMAND FORMAT 

DISJL LOG START LEN 

THE LOG PARAMETER SPECIFIES WHICH LOG TG DISPLAY AND MAY BE 
ONE OFS JOBs SYSTEM» STATS» ENGs ACCOUNTs JOBSTAT. IF LOG IS 
JOBs THEN THE START AND LEN PARAMETERS ARE INTERPRETED AS 
FOLLOWS. . 


THE START PARAMETER SPECIFIES THE FIRST BYTE OF THE LOG 
SEGMENT TO DISPLAY (CNLY FOR JO8 LOG). 


THE LEN PARAMETER SPECIFIES THE NUMBER OF BYTES TO DISPLAY 
(ONLY FOR JOB LOG). 


603024 DISPLAY STACK _ENVIRONMENT 1 DISSE 
THE PURPOSE OF THIS SUBCOMMAND IS TO DISPLAY THE CURRENT 
SEGMENT NUMBER AND TCP OF STACK VALUES FOR EACH RING IN THE 
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CURRENT TASK.» IN FORMAT MODE THE CONTENTS OF THE SEGMENT FROM 
ZERO TO TOP OF STACK ARE ALSO DISPLAYED. 


THERE ARE NO PARAMETERS TO THIS COMMAND. 
$603.25 HANG 

THE PURPOSE OF THIS SUBCOMMAND IS TO CAUSE THE CURRENT TASK TO 
HANG IN A DELAY LOOP WHEN THE DEBUGGER IS EXITED. THE HANG 
COMMAND IS A TOGGLE$ THAT IS» IF HANG IS SET ENTERING THE COMMAND 
AGAIN WILL CLEAR IT AND VICE VERSA. TRAPS ARE LEFT ENABLEDs $0 
THAT THE TASK MAY BE RE-ENTERED. A TASK HUNG IN THIS FASHION 
CANNOT BE RETURNED TO ITS PRE-HUNG STATE. 


THERE ARE NO PARAMETERS TO THIS COMMAND. 
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0 NOSZVE_ PROCESSING O£_JO8_MODE_SOFTWARE_ERRORS 
71 INTRODUCTION 


TASKS RUNNING IN JOB MODE WILL OCCASIONALLY CAUSE AN ERROR 
WHICH IS DETECTED EITHER BY THE HARDWARE OR NOS/VE MONTTOR. THE 
ACTION TAKEN WHEN AN ERROR LIKE THIS OCCURS IS CONTROLLED BY 
VARIOUS SYSTEM ATTRIBUTES. THE PURPOSE OF THIS SECTION IS TC 
DISCUSS THE TYPES OF ERRORS AND THE EFFECT A GIVEN SYSTEM 
ATTRIBUTE WILL HAVE UPON THE HANDLING OF THE ERROR. 


7o2 TYPES OE _ERRORS 


1) BROKEN TASK! A BROKEN TASK IS A TASK IN WHICH THE TRAP 
MECHANISM IS NOT ABLE TO FUNCTION CORRECTLY. NOS/VE MONITOR 
WILL ATTEMPT TO REPAIR THE TRAP MECHANISM AND SEND A BROKEN 
TASK FAULT TO THE TASK. THE SPECIFIC CASES OF A BROKEN TASK 
ARE 


SYSTEM ERROR JOB MODE SOFTWARE HAS DECLARED 
THE TASK TO BE BROKEN. (THIS 
TS A SPECIAL CASE OF BROKEN 
TASK.) 


MONITOR FAULT BUFFER FULL JOB MODE ERRORS ARE OCCURING 
BUT ARE NOT BEING PROCESSED BY 


JOB MODE. 

TRAPS DISABLED A JOB MODE ERRGR HAS OCCURRED 
WHILE TRAPS WERE DISABLED. 

INVALID AQ THE TASK*S AO REGISTER WAS 
INVALID. 

UCR/MCR TRAPS DISABLED UCR/MCR ERROR OCCURRED WITH 


TRAPS DISABLED. 


2) MCR FAULTS THIS ERROR SIGNIFIES THAT JGB MODE CAUSED A 
HARDWARE DETECTED MCR FAULT. THIS MAY BE CAUSED BY SOFTWARE 
OR HARDWARE DETECTED UNCORRECT ABLE ERROR.» 


3) UNKNOWN SYSTEM REQUEST: THIS ERROR SIGNIFIES THAT JOB MODE 
ISSUED A MONITOR REQUEST THAT IS EITHER INVALID OR CANNOT BE 
ISSUED FROM THE RING IT WAS ISSUED FROM. 


4) SEGMENT ACCESS FAULTS: THESE ERRORS SIGNIFY THAT JOB MODE 
ENCOUNTERED OR CAUSED ONE OF THE FOLLOWING ERRORS © 


-~ PAGE FAULT FOR AN ADDRESS GREATER THAN EDI ON A READ-ONLY 
FILE (SEGMENT) 
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- DISK READ ERROR 


THESE ERRORS EITHER ORIGINATE IN NOS/VE MONITOR OR CAUSE THE 
HARDWARE TO EXCHANGE TO MONITOR. DEPENDING ON THE VALUES OF 
CERTAIN SYSTEM ATTRIBUTES» MONITOR WILL HALT OR REFLECT THE ERROR 
BACK TO JOB MODE AS A MONITOR DEFAULT. 


IT (S$ AT THIS POINT THAT THE SYSTEM CORE DEBUGGER CAN BE 
ACTIVATED. (SEE THE DEFINITION OF SYSTEM_DEBUG_LRING IN THE NEXT 
SECTION.) 


THE NORMAL JOB MODE OS ACTIONS FOR THESE FAULTS ARE 


BROKEN TASK EXIT 
MCR FAULT CAUSE CONDITION 
INVALID SYSTEM REQUEST EXIT 
SEGMENT ACCESS CAUSE CONDITION 


7o3 SYSTEM _ ATTRIBUTES ECR ERROR PROCESSING 


THE FOLLOWING SYSTEM ATTRIBUTES CAN BE SET OR DISPLAYED 8Y THE 
SETS A AND DISSA COMMANDS. 


7e30e1 HALTRING 


IF A BROKEN TASK OR MCR FAULT OCCURS AT OR BELOW THE VALUE OF 
HALTRING (P REGISTER RING NUMBER)» NOS/VE MONITOR WILL HALT THE 
SYSTEM. BROKEN TASKS OCCURRING ABOVE HALTRING WILL CAUSE A 
MONITOR FAULT TO BE SENT BACK TO JOB MODE. 


70302 SYSTEMLERROR_HANG_COUNT 

THIS IS THE NUMBER OF BROKEN TASK ERRORS ALLOWED TO OCCUR IN 
ANY GIVEN TASK BEFORE THAT TASK IS CONSIDERED A HUNG TASK. 
70303 HALTLON HUNG_TASK 

IF THIS ATTRIBUTE IS TRUEs THEN AN OCCURENCE OF A HUNG TASK 
WILL CAUSE NOS/VE MONITOR TO HALT THE SYSTEM. IF THE ATTRIBUTE 
I$ FALSE» THE TASK WILL BE SENT A SIGNAL TO "HANG* ITSELF, I.€- 
TO GO INTO AN INFINITE WAIT DOING NOTHING. JO8S WITH HUNG TASKS 
WILL HAVE A *H IN THE STATUS FIELD ON THE OPERATOR CP DISPLAY. 


A HUNG TASK WILL ALSO OCCUR IF ANY ERROR HAPPENS IN JOB MODE 
RING le 
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7e30e4 SYSTEM_DEBUG_RING | 


IF AN ERROR (BROKEN TASKs MCR FAULTs UNKNOWN SYSTEM REQUEST» 
OR SEGMENT ACCESS FAULT) OCCURS AT OR BELOW THE VALUE OF THIS 
ATTRIBUTE (P REGISTER RING NUMBER)» THE SYSTEM CORE DEBUGGER WILL 
BE INVOKED WITHIN THE TASK. AT THAT POINT IN TIME THE TASK 
ENVIRONMENT CAN BE EXAMINED BY USING SYSTEM CORE DEBUGGER 
COMMANDS. 


IF THE RUN COMMAND IS ISSUED TO THE DEBUGGER» THE SYSTEM WILL 
TAKE ITS NORMAL ACTION FOR THE SPECIFIC FAULT. 


7e305 DUMP WHEN _DE BUG 


WHEN THE SYSTEM CORE DEBUGGER IS INVOKED BY A FAULT AT OR 
BELOW SYSTEM_DEBUG_RING AND THE ODUMPLWHEN_DEBUG ATTRIBUTE IS 
TRUE» THE DEBUGGER WILL AUTOMATICALLY CREATE A DUMP OF THE TASK 
(SEE SYSTEM CORE DEBUGGER COMMAND FORMAT). WHEN THE DUMP IS 
COMPLETEs NORMAL FAULT ACTION WILL TAKE PLACE, THE FOLLOWING 
SYSTEM CORE DEBUGGER COMMANDS ARE EXECUTED DURING AN AUTOMATIC 
DUMP 


FORMAT AUTOMATIC DUMP DATA 
DISXCB 

DISMF 

TB 1 1000 

DISTE 

DISSE 

DISJL JOB G 100060 

DM 66300000000 10060(16) 
DM 00400000000 10000(16) 
DM 00500006000 106000(16) 
DM 00600000000 10000(16) 
DISTE 

UNFORMAT 


THIS LIST CAN BE DISPLAYED OR CHANGED USING THE DISACL AND 
SETACL COMMANDS. 


CYCLE lls JANUARY 1983 


| 8-1 
NOS/VE CYCLE 11 HELPFUL HINTS 
83/03/11 


8.0 STAND ALONE DE ADSTART 


A STANDALONE DEADSTART TAPE IS A 9=TRACKs UNLABELEDs I FORMAT» 
1600 8PI DENSITY TAPE (PRODUCED BY THE NVESYS PROCEDURE). TOC 
DEADSTART IN STANDALONE MODE» PERFORM THE FOLLOWING STEPS 


1) SET THE DEADSTART PANEL FOR STANDARD DISK DEADSTART. 


2) PERFORM AN ALTERNATE DEADSTART TO THE NVE DEADSTART TAPE 
USING CTI. THE CTI PARAMETERS ON THE *P* DISPLAY SHOULD BE 
SET AS FOLLOWS 

L = 0 
C = <'€* PARAMETER OF THE SETVE PROCEDURE>D 
D = <*D* PARAMETER OF THE SETVE PROCEDURE 
D = Y WHEN DISPLAY IS TRUE 
D = N WHEN NO DISPLAY>D 
W14 = <'*CH' PARAMETER OF THE SETVE PROCEDURED 


3) THE TAPE SHOULD MOVE AND EVENTUALLY THE MESSAGE “PROCEED” 
WILL APPEAR ON THE LOWER LEFT ON THE CONSOLE. 


4) ENTER CR»MX»BR=C000000000000000 (EDITOR'S NOTE: 16 ZEROS!) 
WHERE MX IS M1 FOR $1 
M2 FOR $2 
M3 FOR $3 


THIS CLEARS THE MEMORY BOUNDS REGISTER WHICH IS SET BY THE NOS 
DE ADSTART. 


5) ENTER DRsP2 THIS DISPLAYS THE CPU REGISTERS» THE SIT 
SHOULD BE CHANGING$ IF NOTs GIVE UP. 


6) AT THIS POINT THE SYSTEM CORE ITS LDADED AND CAN BE PATCHED. 
THE COMMANDS TO DISPLAY AND CHANGE MEMORY ARE DOCUMENTED IN 
IPNOOC. 


7) TO START THE SYSTEM ENTER SS THE CPU REGISTERS SHOULD SPIN3 
IF THEY EVER STOP THE CPU HAS HALTED. 


8) ENTER DD TO DISPLAY THE SYSTEM DAYFILE ON THE RIGHT SCREEN. 

9) ENTER NVE DEADSTART COMMANDS WHEN THE SYSTEM REQUESTS THEM. 
('D = Y* MUST BE SPECIFIED ON THE *P* DISPLAY FOR THIS TO 
HAPPEN.) 

NOTE: STANDALONE DEADSTART IS ALWAYS A ‘QUICK? 
DEADSTARTs SO NO RECOVERY OF PERMANENT FILES IS POSSIBLE. 
"QUICKDS' MODE IS SET INTERNALLY AND NEED NOT BE SPECIFIED. 

19) ENTER OJ TO DISPLAY THE SYSTEM JOB DAYFILE WHEN THE SYSTEM 
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11) NOW THE SYSTEM IS OPERATIONAL AND COMMANDS CAN BE ENTERED. 
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9.0 INTERACTIVE PROJECT_DUMP_ANALYSIS_PROCEDURES 


THE FOLLOWING PROCEDURES WERE DEVELOPED BY THE INTERACTIVE 
PROJECT TO ASSIST THEM IN INTERPRETING DUMPS. THEY GUARANTEE THE 
PROCEDURES WORK IF YOUR USER NAME IS IFP3 OTHERWISE CAVEAT 
EMPTOR. FOR MORE INFORMATION ABOUT THESE PROCEDURES» CONTACT 
FRED BISCHKE. 


THE FOLLOWING DUMP ANALYSIS PROCEDURES ARE AVAILABLE IN THE 
IFP CATALOG 


Jel EQQSIN 


THIS IS A CCL PROCEDURE WHICH BRINGS AN EDD DUMP TAPE CN A 
SPECIFIED 


VSN INTO THE SIMULATOR. THE PROCEDURE CAN BE ACCESSED FROM 
THE IFP , 


CATALOG AS FOLLOWS 
GET» EDDSIM/UN=IFP 


BEGINs»s» EDDSIMs VSN (€ VSN IS THE VSN OF THE EDD DUMP TAPE ) 
Fo2 ANALEXC 


THIS TS A SIMULATOR INCLUDE FILE WHICH OGES A PRELIMINARY 
ANALYSIS OF 


THE CURRENT SIMULATOR EXCHANGE PACKAGE ( WHEN THE SYSTEM 
CRASHES IN TASK 


SERVICES» THIS WILL NORMALLY BE JPS )2 A QR EXC=MON CR OR 
EXC=RMA CAN BE 


USED TO GET INTO ANOTHER EXCHANGE PACKAGE BEFORE DOING THE 
INCLUDE. 


THE INCLUDE FILE IS ANALEXC/UN=IFP. IT CAN BE CALLED FROM THE 
STMULATOR 


AS FOLLOWS 
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*GETsANALEXC/UN=IFP* 3 INCLUDE ANALEXC 
(CARRIAGE RETURN) A LONE CARRIAGE RETURN MUST BE ENTERED AFTER 
AN INCLUDE 
IN ORDER TO START IT UP 


963 SEGQDUMD 


THIS IS A CCL PROCEDURE WHICH CALLS DSDIV TO DUMP A SPECIFIED 
SEGMENT TO . 


A LIST FILE WHICH CAN THEN BE EXAMINED WITH AN EDITOR OR 
PRINTED. 


THE PROCEDURE CAN BE ACCESSED FROM WITHIN THE SIMULATOR AS 
FOLLOWS 
*GETsSEGDUMP/UN@IFP? 3 *BEGIN»s » SEGDUMP sSEGsLENs FILES EXCs CPF? 
THE SEGDUMP PARAMETERS ARE 
SEG - SEGMENT NUMBER IN HEX ( DEFAULT [IS 1 ) 
LENGTH — NUMBER OF BYTES TO OUMP IN HEX ( DEFAULT IS 10000 ) 
LIST - NAME OF THE LIST FILE ( DEFAULT IS LIST ) 
EXC = REFERENCE EXCHANGE PACKAGE ( DEFAULT IS JPS ) 
CPF = NAME OF CHECKPOINT FILE ( DEFAULT IS CPF ) 
IN MOST CASES OF TASK SERVICES DEBUGGINGs ONLY THE SEG 
PARAMETER IS 


NEEDED. 
9% ANALJO8 


THIS IS A CCL PROCEDURE WHICH USES ODSDIVs XEDIT AND THE 
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SIMULATOR TO 


PERFORM AN ANALYSIS GF ALL TASKS IN A SPECIFIED J08. THE 
PROCEDURE CAN 

BE ACCESSED FROM WITHIN THE SIMULATOR AS FOLLOWS 

'GETs ANALJOB/UN=IFP* $ *BEGIN» sANALJOBsSEGsC PF? 


THE ANALJOB PARAMETERS ARE 


SEG - THE MONITOR SEGMENT WHICH CONTAINS THE EXCHANGE PACKAGES 
OF THE J08 ( 14 IS THE SYSTEM JOB» 15 IS JOB 1 ETC. ? ¢€ DEFAULT 
IS 14 ) 


c PF - THE NAME OF THE SIMULATOR FILE { DEFAULT IS CPF ) 
AFTER THE PROCEDURE HAS COMPLETED» A LIST GF THE RMA*S OF THE 
JOBS EXCHANGE PACKAGES CAN BE OBTAINED BY DOING THE 
FOLLOWING 
INCLUDE TPLIST 
(CARRIAGE RETURN) 
aap TRACEBACK OF ALL TASKS IN THE J08 CAN BE OBTAINED 8Y OQCING 
FOLLOWING 
INCLUDE TBLIST 
(CARRIAGE RETURN) 


INCLUDE TBRUN 


(CARRIAGE RETURN) 
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1.0 HAROWARE OVERVIEW 
1.1 AN INTRODUCTION TO CYBER 180 
1.2 €180 INSTANT 


1.3 MODEL INDEPENDENT GENERAL DESIGN SPECIFICATION - 
ARH1700 


200 NOS REFERENCE MANUALS 
2.1 XEDIT V3.0 - 60455730 - 
202 IAF V1.0 USER'S GUIDE = 60455260 


223 NOS VERSION 2 REFERENCE SET ~ VOL 35 60459680 - VOL 4» 
60459690 


204 NOS SYSTEMS PROGRAMMER'S INSTANT - 60459370 
2e5 NOS VERSION 2 OPERATOR/ ANALYST HANDBOOK — 606459316 
2.6 NOS VERSION 2 DIAGNOSTIC INDEX = 60459390 
Ze? NOS A170 ERS 
2e8 NOS A170 GID — ARH3060 
306 NOS/VE REFERENCE DOCUMENTS 


3-1 PROGRAM INTERFACE ERS ~ ARH3610 - GBTAINED FROM KAREN 
RUBEY (482-3966) OR VIA SES.~TOOLDOC 


3e2 COMMAND INTERFACE ERS = ARH3609 - OBTAINED FROM KAREN 
RUBEY (482-3966) OR VIA SES.TOOLDOC 


3e3 NOS/VE PROCEDURES AND CONVENTIONS - SESD010 ~ OBTAINED 
BY SES.TGOLDOC 


364 LISTING OF ALL NOS/VE MODULES - OBTAINED BY 
SESsDEVL.LISTNVE. SEE INTEGRATION PROCEDURES NOTEBOOK 
FOR DETAILS. 


365 NOS/VE INTERNAL INTERFACE MAINTENANCE PROCEDURES MEMO 
AVAILABLE FROM S.C. WOOD. 


3e6 INTEGRATION PROCEDURES NOTEBOOK CBTAINED BY 
ACQUIREs IPNDOC/UN=DEV1L. SESePRINTsIPNDQC, 


307 NOS/VE INSTALLERS HANDBOOK = GBTAINED BY 
ATTACHsTHB/UN=MDC. ScSePRINT IHB. 
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406 
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REFERENCE DOCUMENTS 

CYBIL INTERACTIVE DEBUGGER — ARH3142 
SES USER'S GUIDE — ARH1833 

CYBIL SPECIFICATION - ARH2298 

C180 ASSEMBLER ERS - ARH1693 
SIMULATOR ERS - ARH1729 

VEGEN ERS - ARH2591 

VELINK ERS - ARH2816 

SIMULATED I/0 ERS - ARH3125 

OBJECT CODE UTILITIES ERS - ARH2922 
CYBIL IMPLEMENTATION DEPENDENT HANDBOOK - ARH3078 


CYBER 180 INTERACTIVE DEBUG EXTERNAL REFERENCE 
SPECIFICATION AND USERS GUIDE - $4028 


CYBER 180 I1 ASSEMBLER ERS = ARH3945 
ERS FOR SOURCE CODE UTILITY - ARH3883 
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DieG KEYPOINTS 


D1.0 KEYPQINTS 


KEYPOINTS ARE USED TO GIVE AN EXECUTION TIME TRACE OF 
PROGRAM FLOW BY SHOWING THAT A GIVEN FUNCTION IS BEING PERFORMED 
(THAT IS» THAT A GIVEN PROCEDURE IS BEING EXECUTED) . 

KEYPOINTS MAY ALSO BE USED TO DISPLAY REQUEST PARAMETERS» 
STATUS AND ERROR CONDITIONS. 


Dlel ISSUING _KEYPOINTS_EROM_CYBIL CODE 
THE GENERAL FORM OF THE KEYPOINT INSTRUCTION IS 
#INLINE ('KEYPOINT's KEYPOINT_CLASS» OSKSM * DATAs KEYPOINT_ID)3 
Dlelel KEYPOINT CLASSES 


A KEYPOINT IS IDENTIFIED BY BOTH CLASS» AND IDENTIFIER. 
THE FOLLOWING DECK EXPLAINS THE PARTITIONING OF THE KEYPOINT 
CLASSES. 


DSDKEYS 
COMMON 
CONST 
0 KEYPOINT CLASSES 
0 
0 THE 16 KEYPOINT CLASSES SUPPORTED BY THE HARDWARE ARE 
O PARTITIONED BETWEEN THE SYSTEMs PRODUCT SET AND USER AS FOLLOWS. 


OSKSSYSTEM_CLASS = G@ 0 OD ee 5 2s 
OSKSPRODUCTLSETICLASS = 6 0 6 «2 10 29 

: OSKSUSER_CLASS = 11 O 11 «+ 14 2» 
OSKSPMF_CONTROL = 153 


KEYPJINT MULTIPLIER 
BY CONVENTION» : 


THE 32 BIT KEYPOINT CODE SUPPORTED BY THE HARDWARE 
TIS SPLIT INTO TWO FIELDS. THE RIGHT FIELD CONTAINS A KEYPOINT 


ooagcoo 
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DL. KEYPOINTS 
Die1.1 KEYPOINT CLASSES 


IDENTIFIER WHICH IS USED TO IDENTIFY A FUNCTION WITHIN A 
KEYPOINT CLASS. FOR EXAMPLE» IF A PARTICULAR KEYPOINT CLASS 
REPRESENTS EXIT FROM A PROCEDUREs 

THEN THE KEYPOINT IDENTIFIER MIGHT IDENTIFY EXIT FROM 
PROCEDURE A VERSUS EXIT FROM PROCEDURE B. 

THE LEFT FIELD IS USED AS A DATA PARAMETER APPROPRIATE TO THE 
FUNCTION IDENTIFIED BY THE KEYPOINT IDENTIFIER.» IN THE 
PROCEDURE EXIT EXAMPLE ABOVEs 
THE DATA PARAMETER FIELD MIGHT BE USED TO INDICATE THE 
STATUS OF THE PROCEDURE CALL. 

THE KEYPOINT MULTIPLIER IS USED TO PARTITION THE KEYPOINT 
CODE INTO THE TWO FIELDS.» THE DATA PARAMETER SHOULD BE 
MULTIPLIED BY THE KEYPOINT MULTIPLIER TO PREVENT IT FROM 
OVERLAPPING THE KEYPOINT IDENTIFIER FIELD. 


OSOooooo0ocEGooctocs 


CONST 
OSKSM = 40963 


Dlele2 NOS/VE KEYPOGINT CLASSES 


FIVE KEYPOINT CLASSES NAMED ENTRY» EXIT» UNUSUAL» DEBUG» 
AND DATA ARE DEFINED» TAKING FIVE OF THE AVAILABLE SIXTEEN CLASSES 
BY THE HARDWARE. 


ENTRY ~ EVERY GATED PROCEDURE PLUS ALL MAJOR INTERNAL PROCEDURES 
(THOSE SHARED ACROSS FUNCTIONAL AREAS) SHOULD CONTAIN A 
KEYPOINT OF THIS CLASS.» THESE KEYPOINTS SHOULD BE PLACED 
AS CLOSE AS POSSIBLE TO THE ENTRY TO THE PROCEDURE. 


EXIT = EVERY GATED PROCEDURE PLUS ALL MAJOR INTERNAL PROCEDURES 
(THOSE SHARED ACCROSS FUNCTIONAL AREAS) SHOULD CONTAIN A 
KEYPOINT OF THIS CLASS. THESE KEYPOINTS SHOULD BE PLACED 
AS CLOSED AS POSSIBLE TO THE EXIT TO THE PROCEDURE. 


UNUSUAL = EVERY SITUATION WHICH IS UNEXPECTED OR QUITE UNUSUAL 
SHOULD CONTAIN A KEYPOINT OF THIS CLASS. IT IS INTENDED 
THAT THESE KEYPOINTS WOULD BE ENABLED AT ALL TIMES. THE 
FREQUENCY OF ENCOUNTERING THESE KEYPOINTS SHOULD BE 
VERY LOWe THE DATA KEYPOINT CLASS IS NOT ALLOWED IN 
CONJUNCTION WITH A KEYPOINT OF CLASS UNUSUAL. 


DEBUG = THESE KEYPOINTS ARE FOR PROVIDING ADDITIONAL TRACE 
INFORMATION AS AN ASSIST IN DEBUGGING HARDWARE OR SOFTWARE 
PROBLEMS.» DEBUG CLASS KEYPOINTS WOULD BE MOST USEFUL IN 
THE MORE COMPLEX AREAS OF THE SYSTEM. 

DATA - THIS KEYPOINT CLASS CAN BE USED WITH ENTRY» EXITs AND 
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DEBUG KEYPOINTS FOR THE GATHERING OF EXTRA DATA. ALL DATA 
KEYPOINTS ENCOUNTERED ARE SUPPLYING ADDITIONAL DATA WHICH 
WILL BE ASSOCIATED WITH THE LAST ENTRY» EXIT» OR DEBUG 

KE YPOINT. 

DATA KEYPOINTS SHOULD BE USED WITH CARE SINCE THE PMF 
HARDWARE CAN ONLY BUFFER UP 16 KEYPOINTSs KEYPOINT CLUSTEG 
CAN CAUSE LOST KEYPOINTS. 


THE FOLLOWING DECK DEFINES THE NOS/VE OS CLASS CONSTANTS. 


OSOKEYC 
COMMON - 
ODEFINE KEYPOINT CLASS CQDES. 


CONST 
OSKSDATA = OSKSSYSTEMLCLASS + Os 0 OS = DATA KEYPOINT2 
OSKSUNUSUAL = OS KSSYSTEMLCLASS + Ll» OU OS — UNUSUAL KEYPOINT.2 
OSKSENTRY = OSKSSYSTEM_LCLASS + 259 OF OS = ENTRY KEYPOINTI2 
OSKSEXIT = QSKSSYSTEMLCLASS # 35 OX OS = EXIT KEYPOINT2 
OSK$DEBUG = DSKSSYSTEM_CLASS + 43 0D OS —- DEBUG KEYPOQINT.2 


OFCALLCs OSDKEYS 
Dlele3 KEYPOINT DATA AND IDENTIFICATION 


UPON SUCCESSFUL EXECUTION EACH KEYPOINT INSTRUCION WILL 
PROVIDE A TOTAL OF 32 BITS OF INFORMATION, OQUR CONVENTION USES 
12 8ITS OF THIS FOR KEYPOINT IDENTIFICATION AND THE REMAINING 20 
BITS AS USER SUPPLIEC DATA. TRY TO USE THIS 20 BITS TO SUPPLY 
MEANINGFUL INFORMATION (TASKIDs SEGMENT NUMBER» FILE IDENTIFIER, 
QUEUE LENGTH» PAGE NUMBER» TIMEs ETC.). THE KEYPOINT ; 
IDENTIFICATION CODES ARE DEFINED IN THE ATTACHED COMMON DECK. ON 
DATA CLASS KEYPOINTS THE DATA BELONGS TO THE PREVIOUS KEYPOQINT 
AND THE FULL 32 BITS IS AVAILABLE FOR ADDITIONAL USER DATA. 


Dl.1le4 EXAMPLE ISSUING KEYPOINTS 
ENTRY KEYPOINT WITH DATA 
#INLINEC*KEYPOINT!'s» OSKSENTRY» OSKSM*¥TASKID.INDEXs 


TMKSEXITLTASK) $ 


UNUSUAL KEYPOINT WITH NO DATA 
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D1leQ KEYPOINTS 
eodnee SrANEee 2 2UINS KEY POINTS 


#MINLINE (*KEYPOINT*»s OQSKSUNUSUAL»s O» MMKSNO_MEMDRY)3 
ENTRY KEYPOINT WITH EXTRA DATA 


#INLINE CIKEYPOINT's OSKSENTRYs OSKSM * SEGMENT_NUMBER » 
MMKSPAGE_FAULT )3 
#INLINE C*KEYPOINT*» OSK#DATAs OFFSETs 0)3 


Dlele5S KEYPOINT IDENTIFIERS 


EACH AREA OF THE OPERATING SYSTEM HAS BEEN GIVEN A RANGE OF 
IDENTIFIERS TO USE FOR KEYPOINTS. THE BASE FOR EACH AREA IS 
DEFINED ON COMMON DECK QSDKEYD. EACH AREA SHOULD 
HAVE A DECK XXDKEY (WHERE XX IS THE PRODUCT IDENTIFIER) 

WHERE THE AREAS KEYPOINT CONSTANTS ARE DEFINED(E.GeTMKSEXIT_LTASK). 
PLEASE REFERENCE THE SECTION ON KEYPOINT DESCRIPTION DECKS» FOR AN. 
EXAMPLE OF ONE OF THESE DECKS. 


OS DKEYD 
COMMON | 
OTHIS DECK DEFINES CONSTANTS FOR USE WITH KEYPOINTS.» 


ODEFINE BASE KEYPOINT PROCEDURE IDENTIFIERS FOR EACH AREA OF THE 
OOS. | 


CONST 
AMKSBASE = 100» 0100 - 1492 
BAKSBASE = 2005 0200 - 2492 
CLKSBASE = 2505 0256 — 2992 
CMKSBASE = 3005 0300 — 3492 
DBKSBASE = 3505 0350 - 3992 
DMKSBASE = 400» 0400 - 5492 
FMKS$BASE = 5505 C550 = 5992 
ICKSBASE = 600s 6600 —- 6492 
IFK$BASE * 6505 G650 — 6992 
TIKSBASE = 7005 0706 - 7492 
INK$BASE = 750,» 0750 - 7992 

' JMKSBASE = BOO» C800 — 8492 
LGKS BASE = 850,» 0850 - 8992 
LLKSBASE = 900» C906 - 9492 
LOKSBASE = 950» 0950 - 9992 
LUKSBASE = 1000» 01000 — 10492 


MLKSBASE = 1050» 01050 - 10992 
MMKSMONITORIBASE = 1100s 61100 - 11492 
MMKSJOB_LBASE = 1150s 61150 - 11992 
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MSKSBASE = 1200» 01200 — 12492 
MTKSBASE = 1250s 01250 - 12992 


DCKSBASE = 1300» 01300 - 13492 
DFKSBASE = 13505 01350 - 13992 
OQSKSBASE = 1400», 01400 — 14492 
PFKSBASE = 15005 01500 - 15492 
PMKSBASE = 1600s 01600 — 16992 
RHKSBASE # 1750» 01750 - 17992 


SRKSBASE 18060, 01800 18192 
STKS$BASE = 18505 01850 ~ 18992 
TMKSMONITOR BASE = 1900» 61900 - 19492 
TMKSJOB_LBASE = 1950» 01950 - 19992 
JSKSMONTTOR BASE = 2000» 02000 - 20492 
JSKSJOBLBASE = 2050» 62050 - 20992 
AVKSBASE = 2100» 02160 —- 21492 
SFKEBASE * 2150» 02150 —- 21992 
IOKSBASE = 22005 02200 — 22492 
RMKSBASE = 2250» 02250 ~— 23002 
MTKSASSEMBLY_LANGUAGE_BASE = 40003 04000 - 40952 
0 OS ASSEMBLY LANGUAGE 4000 - 40952 
OFCALLCs OSOKEYC 


Dl.2 COLLECTING KEYPOINTS 
D1e2.1 ON THE SIMULATOR 


| WHEN EXECUTING ON THE SIMULATOR ALL KEYPOINT INSTRUCTIONS CAUSE 
AN ENTRY TO BE ADDED TO THE LOCAL FILE SESSMKF. 


D1.2.2 ON THE HARDWARE 


SOFTWARE KEYPOINT COLLECTION IS AVAILABLE FOR COLLECTING SYSTEM 
AND JOB KEYPOINTS. SYSTEM KEYPOINTS ARE THOSE KEYPOINTS IN THE 
ENTIRE SYSTEM AND JOB KEYPOINTS ARE ONLY THOSE DEALING WITH A 
PARTICULAR JOB. ONLY ONE SYSTEM KEYPDINT COLLECTOR 
CAN BE ACTIVE AT ONE TIMEs BUT EACH JOB MAY HAVE AN ACTIVE 
JOB KEYPOINT COLLECTOR. SOFTWARE KEYPOINTS ARE COLLECTED CN A 
FILE LOCAL TO THE JOB IN WHICH THE KEYPOINT COLLECTION TASK IS 
RUNNING. AFTER KEYPOINT COLLECTION IS TERMINATED THIS FILE CAN 
SAVED ON THE 170 SIDE AND ANALYZED BY THE KEYPOINT ANALYZER. 
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THREE COMMANDS ARE SUPPLIED TO UTILIZE THE KEYPOINT FEATURE 
ACTKs DEAK» AND EMIK,. 
Dl 20201 ACTK COMMAND 


THE ACTK COMMAND INITIATES KEYPOINT RECORDING AND COLLECTING. 
IT HAS THE FORM OF 


ACTK»s MODE sENVIRONMENT sMONITOR_MASK » J OB_LMAS Ko 
START_CLASSsSTOP_CLASS »s KEYPOINT_FILE» 
COLLECTOR BUFFER. SIZEsCOLLECTOR_DELAY 


MODE OR M ® *SOFTWARETs St» PARAMETER IS 
"HARDWARE *%s OR *H! — REQUIRED 

ENVIRONMENT OR E = #JOBYs !3%s PARAMETER IS 
*SYSTEM's OR *S! REQUIRED 

MONITOR_LMASK OR MM = A LIST OF INTEGERS DEFAULT IS ALL 


RANGING FROM O TO 15 
EXAMPLES MM=(22629912) 


JOB_MASK OR JM = A LIST OF INTEGERS DEFAULT IS ALL 
RANGING FROM O TO 15 
EXAMPLES JM={09355) 


START_LCLASS OR START * AN INTEGER IN DEFAULT IS 15 
THE RANGE FROM O TO 15 
THIS SPECIFIES THAT KEYPOINT COLLECTION 
SHOULD NOT START UNTIL A KEYPOINT OF THIS 
CLASS IS ENCOUNTERED. 


STOP_LCLASS OR STOP = AN INTEGER IN DEFAULT IS 15 
THE RANGE FROM O TO 15 
THIS SPECIFIES THAT KEYPOINT COLLECTION 
SHOULD STOP WHEN A KEYPOINT OF THIS 
CLASS IS ENCOUNTERED. 


KEYPOINTLUFILE OR KF = FILE NAME DEFAULT IS 
THIS SPECIFIES THE FILE ON WHICH $LOCAL .KEYFILE 
KEYPOINTS ARE TO BE SAVED. 

THIS PARAMETER IS USED 
ONLY WITH SOFTWARE KEYPOINTS. 


COLLECTOR _BUFFER_SIZE OR CBS = AN INTEGER DEFAULT IS 10000 
IN THE RANGE FROM 1000 TO 100s000 
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DieO KEYPOINTS 
Dle2@e201 ACTK COMMAND 


THIS PARAMETER IS USED ONLY WITH 

SOFTWARE KEYPOINTS. 
COLLECTORLDELAY OR CD = AN INTEGER DEFAULT IS 50 

IN THE RANGE FROM 10 TO 1002060 

THE VALUE SPECIFIED IS THE DELAY 

PERIOD IN MILLISECONDS. THIS 

PARAMETER IS USED ONLY WITH 

SOFTWARE KEYPOINTS. — 


Dle2e2e2 DEAK COMMAND 


THE DEAK COMMAND TERMINATES KEYPOINT COLLECTION. 
DEAK sENVIRONMENT 
ENVIRONMENT OR E = *JCBYs tts DEFAULT IS J08 
*SYSTEM*s OR *S* 
D1le2e203 ENIK COMMAND 


THE EMIK COMMAND IS USED TO ISSUE KEYPOINTS. 
EMIKsCLASS»sCODE 


CLASS = AN INTEGER IN THE RANGE DEFAULT IS 15 
FROM O TO 15 


CODE = AN INTEGER IN THE RANGE DEFAULT [5S 0 
FROM O TO OFFFFFFFF(16) 


AFTER KEYPOINT COLLECTION IS TERMINATED THE KEYPOINT FILEs 
CAN BE SAVED ON THE 170 BY A REPLACE_FILE WITH 856 
CONVERSTON. FOR EXAMPLE. 

REPLACE _FILEsKEYFILE »s KEYFILEs8 56 


ON THE 170 SIDE THIS CAN BE ANALYZED BY USING NVEKEY>» 
FORMAT = HDW. 
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D1+3 KEYPOINT_ANALYZER_ UTILITY 
Dle3e1 NVEKEY 


THE SESSMKF FILE PRODUCED ON THE SIMULATOR» OR THE 
KEYFILE PRODUCED ON THE HARDWARE CAN BE REFORMATTED INTO A 
READABLE LISTING BY EXECUTING THE FOLLOWING PROCEDURE. 


SES»NVEKEY CKPF= ] CFORMAT= 1 CKD= 7 CAREA= J] 

NVEKEY CREATES A SIMULATOR GENERATED KEYPOINT TRACE FILE. 

THE "KPF® PARAMETER IS THE KEYPOINT FILE USED AS INPUT. 

THE "KD" PARAMETER IS A FILE OR LIST OF FILES WHICH DEFINE(S) 
THE KEYPOINT DESCRIPTIONS. 


m==-P ARAME T ER=-===--DEF AULT—-------ALLOWABLE VALUES--~---- 
KPF 1SESSMKF * FILE NAME 
"KEYFILE! IF FORMAT=HDW 
FORMAT "SIM? SIM>HDW 
KD *KEYDESC ! FILE NAME(S) 
AREA EUS ERE USER NAME 


IF RUN INTERACTIVELYs WHEN THE PROCEDURE TERMINATES THE 
REFORMATTED LISTING IS ON LOCAL FILE KEYFILE. 


D1.e3e2 KEYPOINT DESCRIPTION FILE 


THE KEYPOINT DESCRIPTIONS ARE USED BY THE KEYPOINT 
ANALYZER UTILITY TO DIRECT THE REFORMATTING OF THE 
KEYPOINT INFORMATION. 


Dle3e2el KEYPOINI_DECKS 


EACH AREA HAS A KEYPOINT CONSTANT DECK XXDKEY (WHERE XX 
IS THE PRODUCT ID). THE KEYPODINT DESCRIPTIONS ARE NOW 
INCLUDED IN THIS DECK IMMEDIATELY FOLLOWING THE KEYPOINT 
CONSTANTS (SIMILIAR TO THE MESSAGE TEMPLATES). 


EACH DESCRIPTION HAS THE FOLLOWING FORMAT. , 
NOTE: EACH ELEMENT CIF GIVEN) IS POSITIONALLY DEPENDANT. 


OCLASS CSUBLIDLFIELD] KEYPOINT_LABEL CDATA_LABEL] CDATA_LFIELD] 
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CLASS OF KEYPOINT = REQUIRED 
E ENTRY 
X EXIT 

~ -U UNUSUAL 
D DEBUG 


SUB_LID_FIELD - OPTIONAL — (DESCRIBED LATER) 


KEYPOINT_LABEL - REQUIRED - THIS I5 A STRING THAT 
DESCRIBES THE PURPOSE OF THE KEYPOINT. 


DATALLABEL = OPTIONAL = THIS IS A STRING OF UP TO 8 
CHARACTERS DESCRIBING THE DATA PORTION OF THE KEYPOINT. 


DATALFIELD.DESCRIPTOR = OPTIONAL - THIS CONSISTS OF DATA 
FORMAT AND LENGTH. 
DATA_ FORMAT 
H HEX 
I INTEGER (DECIMAL) 
A ASCII 
CONCATENATED TO THIS IS THE LENGTH OF THE DATA PORTION OF 
THE KEYPOINTs IN DECIMAL BITS. 
FOR EXAMPLE: 120 


D1e3e2elel EXAMPLE KEYPOINT DECK 


STOKEY 
COMMON 


0 PURPOSE 
+) THIS DECK CONTAINS ALL OF THE SET MANAGER KEYPCINT CONSTANTS. 


CONST 
STKSCREATE_SET = STKSBASE + 1» 
OE "STPSCREATE_LSET® "RING * H 2 
OX *STPSCREATELSET® "STATUS * I20 2 


STK $PURGE_SET = STKSBASE + 2» 
OF *STPSPURGELSET® 2 
OX *STPSPURGE_LSET! "STATUS ' 120 2 


STKSCANT_LDM_STORE_LSET_ORD = STKSBASE » 
OU "CANT OMPSSTORELAVTLSETLORDOINAL® "AVTINDX * H20 2 


STKSPF_LROOTLSIZE = STKS$BASE + 53 
OD ®PFLROOTLSIZE*® *ROOTSIZ * H20 2 
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27? PUSH (LIST s= OFF) 22 
O*FCALLC OSDKEYD 
22 POP 27 


D13e2e1.2 SUBLIDLFIELD 


THIS OPTIONAL FIELD ALLOWS A MEANS OF SUBDIVIDING A SINGLE 
KEYPOINT INTO SEVERAL DESCRIPTORS. THE PARTICULAR DESCRIPTOR 
IS CHOSEN ON THE BASIS OF A SELECTABLE NUMBER OF BITS OF THE 
DATA FIELD. THIS FIELD HAS THE FOLLOWING FORMAT 


SUBLTD_LLENGTH. SUBLID MATCH 


SUBLID_LLENGTH ~- THIS SPECIFIES THE NUMBER OF BITS (RIGHT MOST) 
OF THE DATA FIELD TO USE» TON DETERMINE WHICH 
DESCRIPTOR TO CHOOSE. 


SUBLIDL-MATCH - THIS SPECIFIES THE INTEGER IDENTIFIER USED TO 
MATCH THE DATA PORTION. 


EXAMPLE 
MMKSPAGE_FAULT = MMKSMONITOR_BASE + 6» 
OE "PAGE FAULT PROCESSOR?® 2 
OE 4-1 "PAGE FOUND IN AVAIL QUEUE* '!PFTI * H162 
OE 4.2 "PAGE FOUND IN AVAIL MODIFIED QUEUE * '*PFTI * H162 


IF THIS KEYPOINT WAS ISSUED AND PRODUCED DATA OF 25 THE 
DESCRIPTOR WITH THE SUB_LID_MATCH FIELD OF 2 WOULD BE 
USED ("PAGE FOUND IN AVAIL MODIFIED QUEUE? ), 
THESE KEYPOINTS WERE ISSUED WITH A SUB_LID_LENGTH = 4» 
THUS THE 4eX.e FOR EXAMPLE 
#INLINE ('KEYPOINT's OSKSENTRY»s OSKSM * 
(PFTI * 16 02 ** SUBLID_LENGTH2 + 20SUB_ID_MATCH2)>s 
MMK $PAGE_FAULT)3$ 


D1.3+2e2 GENERATING THE DESCRIPTOR FILE 

THE KEYPOINT DESCRIPTIONS ARE KEPT ON A FILE CALLED KEYDESC 
ON THE INTEGRATION CATALOG. THIS FILE MAY BE PRODUCED BY 
SES eGENCOMP M=OSMKEYS AB=((NOSVEPLsOSLPIsINT2)) CF=KEYDESC 
THE USER MAY ADD KEYPOINTS TO HER XXDKEY DECK LOCALLY» AND 
THE KEYDESC FILE MAY BE PRODUCED AS ABOVEs SPECIFYING THE 
ADDITIONAL LOCAL BASES. THE KEYDESC FILE MAY THEN BE SAVED 
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ON HER CATALOG. 


IF NEW KEYPOINT DECKS ARE ADDEDs *CALLC *§ TO THESE NEW DECKS 
CHOULD BE ADDED TO THE DECK OSMKEYS»s AND THE APPROPRIATE 
BASE CONSTANTS ADDED TO DECK OSDKEYDO. 


WHEN TRANSMITTING CHANGES TO KEYPOINT DECKSs BE SURE TO INFORM 
INTEGRATIONs VIA THE TRANSITTAL FORM» TO RECREATE THE FILE 
KEYDESC. 


Dle3e203 QQ3MKEYS FORMAT 


THIS SECTION WILL ONLY BE USEFUL TO THOSE DESIRING TO ADD 
ADDITIONAL KEYPOINT CLASSES» KEYPOINT CLASS BASE CONSTANTS» 
GR NEW KEYPDINT DESCRIPTION DECKS. 

THE CLASSES» IDENTIFIERS» AND DESCRIPTIONS ARE EACH BUFFERED 
BY A COMMENT. FOR EXAMPLEs TO ADD ANOTHER KEYPOINT CLASS 
O$$$ START KEYPOINT CLASSES $332 
CONST 

PSKSENTRY = OSKSPRODUCTLSETLCLASS + 13 OF PS - ENTRY KEYPOINT2 
O$$3 END KEYPOINT CLASSES $$$ 2 
NOTE: THE E FOLLWOING THE "O" WILL BE USED IN THE DESCRIPTION. 


THIS NEW SECTION SHOULD BE APPENDED TQ THE END OF THE KEYDESC 
FILE. READERS DESIRING MORE INFORMATION SHOULD REFERENCE THE 
ATTACHED BNF» AND THE ATTACHED DECKS OSMKEYS. 


THE FOLLOWING REPRESENTS A SAMPLE OF HOW TO SET UP 
THE DESCRIPTION MODULE. 
NOTE? COMMENT PUT AROUND *CALL FOR SAKE OF DOCUMENTATION ONLY. 


DSMKEYS 

22 LEFT t= ls RIGHT s= 110 2? 

MODULE KEYPOINT_DESCRIPTION_FILE3 
O*¥CALLCs OSOKEYS 

O$$3 START KEYPOINT CLASSES $$$2 
O¥CALLCs OSDKEYC 

0$%$$ END KEYPOINT CLASSES $$%2 

O$$%$ START KEYPOINT IDENTIFIER BASES $$%2 
O*CALLCs OSDKEYD 

O$$$ END KEYPOINT IDENTIFIER BASES $$$2 
OS$$ START KEYPOINT DESCRIPTIONS %$3$2 
O*CALLC» AMDKEY 

C*¥CALLCs BADKEY 

O* CALLCs CLDKEY 

O*CALLC sCMDKEY 
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O*FCALLCs DBDKEY 
O*¥CALLC» DMDKEY 
O*¥CALLCs FMDKEY 
O*¥CALLCs ICDKEY 
O*FCALLCs TFDKEY 
O*FCALLCs IIDKEY 
O*CALLCs INDKEY 
OFCALLCs JINDKEY 
O*CALLCsLGDKEY 
O*CALLC»LLDKEY 
O*¥CALLCs LODKEY 
O*CALLC sLUDKEY 
O*¥ CALLC»MLDKEY 
O*CALLC » MMDMKEY 
O*CALLCs MMDJKEY 
O*CALLCs MSDKEY 
O*CALLC» MTDKEY 
OFCALLC» GCDKEY 
O*¥CALLC» OFDKEY 
O*¥CALLCs OSOKEY 
O*FCALLC»s PFDKEY 
O*CALLC > PMDKEY 
O*¥CALLCs RHDKEY 
D¥CALLCs SROKEY 
O*CALLCsSTDKEY 
O*CALLCs TMDMKEY 
OFCALLCs TMDJKEY 
O*CALLCs JSD MKE Y 
O*¥CALLCs JSDJKEY 
O*FCALLCs AVDKEY 
O*CALLCs SFOKEY 
O*CALLCs INDKEY 
O*¥CALLCs RMDKEY 
6O$$$ END KEYPOINT DESCRIPTIONS $$%2 
MODEND KEYPOINT_DESCRIPTION_LFILE3 


Dle% REFORMATTED FILE DESCRIPTION 


THE OUTPUT FROM PROCEDURE NVEKEY IS A FILE CALLED KEYFILE. 
THIS REFORMATTED LISTING CONTAINS TWO SECTIONS.» THE FIRST 
SECTION IS A LISTING OF ALL THE KEYPOINTS IN THE ORDER THEY WERE 
ISSUED. THE SECOND SECTION IS A SUMMARY OF THE NUMBER OF TIMES 
EACH KEYPOINT OCCURED. 

EACH LINE IN THE FIRST SECTION HAS THE FOLLOWING FORMAT} 


RT TSL DATA DATA_LABEL S TN AREALID KPLLABEL 
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THE RT FIELO DESIGNATES THE VALUE OF THE FREE RUNNING 
MICROSECOND CLOCK (TIME SINCE DEADSTART) WHEN THE KEYPOINT WAS 
EXECUTED. ON THE SIMULATOR THE CLOCK IS INCREMENTED BY 1 FOR 
EACH INSTRUCTION EXECUTED. 


THE TSL FIELD DESIGNATES THE TIME (MICROSECONDS) SINCE THE 
LAST KEYPOINT INSTRUCTION WAS EXECUTED. 


THE DATA FIELD SPECIFIES THE VALUE OF THE DATA PORTION CF THE 
KEYPOINT IN THE FORMAT DESCRIBED IN THE KEYPOINT DESCRIPTION 
FILE FOR THIS KEYPOINT. 


THE DATALLABEL FIELD IS THE DATA LABEL FIELD FROM THE 
KEYPOINT DESCRIPTION FILE FOR THIS KEYPOINT. 
THIS IDENTIFIES THE DATA BEING DISPLAYED. 


THE S$ FIELD SPECIFIES THE STATE OF THE MACHINE WHEN THE 
KEYPOINT WAS ISSUED AND IS ONE OF THE FOLLOWING 


M - MONITOR MODE 
J - JOB MODE 


AN * PRECEDING THE S FIELD INDICATES THAT 
TRAP PROCESSING IS ACTIVEs THAT IS THE TRAP HANDLER HAS 
BEEN ENTERED» BUT NOT EXITED. 


THE TN FIELD GIVES THE GLOBAL TASK ID OF THE TASK THAT 
WAS EXECUTING WHEN THE KEYPOINT WAS ISSUED. 
THE SYSTEM IS TASK 1. 


THE AREALIO FIELD IS THE AREA IDENTIFIER FOR THE AREA 
ISSUING THE KEYPOINT. 


THE KPLLABEL IS THE KEYPOINT LABEL FIELD FROM THE KEY PCINT 
DESCRIPTION FILE. THIS DESCRIBES THE KEYPOINT. 


NOTE: FOR AN UNDEFINED KEYPOINTs THAT IS» ONE WHICH HAS NO 
DESCRIPTOR ENTRYs THE AREALID FIELO CONTAINS THE 
INTEGER FOR THE KEYPOINT CLASS» THE CLASS FIELD 
ON THE OUTPUT IS SPECIFIED AS "UND"» AND THE KP_LABEL 
BECOMES THE IO_NUMBER OF THE KEYPOINT. 
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D1.5 BNE_KEYPOINT. DE SCRIPIION 


<ANALYZER_DESCRIPTOR_INPUT> 832 <KEYPOINT_CLASS_ALLOCATION_DECK> 
: C <DEFINITION_DECKD oe. 1 


CKEY POINTLCLASS_W ALLOCATION DECK > tts <CYBIL CODE AND/OGR COMMENTS) 
C <CLASS_BASE_DEFINITIONS>D ese J 
<CYBIL CODE AND/OR COMMENTS) 


CCLASSIBASE_LDEFINITIGNS> ts <CLASS_BASELID> <SPC> = <SPC> <BASED 


CCLASS_BASE_LID> 22= OSKSSYSTEM_CLASS 1 OSKSPRODUCT_LSET_CLASS 1 
OSKSUSER CLASS 1 OSKSPMF_CONTROL 


<SPC> 33= CE <SPACE> ese ] 
<BAS E> 


<DEFINITION_DECK> 232 <CLASS_DEFINITION_DECK> 1 
<BASE_DEFINITION_OECK> 1 
<KEYPOINT_DEFINITION_DECK> 


<CLASS_DEFINITION_DECK> t8= O$$%$ START KEYPOINT CLASSES %$%2 
<CYBIL CODE AND/OR COMMENTS> 
£ <CLASS_DEFINITIONS> see ] 
<CYBIL CODE AND/OR COMMENTS> 
O$3$ END KEYPOINT CLASSES $$$2 


<CLASS_DEFINITIONS> %= <KEYPOINT_CLASS> <SPC> = <SPC> 
<CLASS_BASE_ID> <OFFSET> 
O <KEYPOINT_CLASS_ID> <CYBIL COMMENT> 
<KEY POINT CLASS> 
<OFFSET> t3= + <SPC> <INTEGER> <DELIMITER> 
<DELIMITER> t2= 5 1 3 
<KEYPDINT_CLASS_ID> t8= <CHARACTERD> 
<BASE_DEFINITION_DECK> t= 
O$$ START KEYPOINT IDENTIFIER BASES $$$2 
| <CYBIL CODE AND/OR COMMENTS> 
[ <RANGE_BASE_DEFINITIONS> oe ] 
<CYBIL CODE AND/OR COMMENTS> 
0$$$ END KEYPOINT IDENTIFIER BASES $$$2 
<RANGE_BASE_DEFINITIONS> t= <KEYPOINT_BASE> <DELIMITER> 
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<BASE_RANGE> 
<KEYPOINT_BASED> t2= <SPC> <BASE_LID> <SPC> = <SPC> <BASED> 
<BASE_ID> 332 <IDENTIFIER> 
<BASELRANGED #32 <SPC> O <LOW_BASE> <SP> — <HIGHIBASE> € 2 ] 
<LOW_BASE>D tt= <INTEGERD 
<HIGH_BASE> 2%= <INTEGERD> 
CKEYPOINT DEFINITION DECK> 
O$$$ START KEYPDINT DESCRIPTIONS $$$2 

<CYBIL CODE ANOD/OR COMMENTS> 

C <XXDKEY_DECK> ese J] 

<CYBIL CODE AND OR COMMENTS» 

0$%3% END KEYPOINT DESCRIPTIONS $$#2 


<XXDKEY_DECK> t= £€ <CYBIL CODE AND/OR COMMENTS> 
C <KEYPOINTLINFOD eee ] 


CKEYPOINTLINFOD t2= <KEYPOINT_CONSTANT_LINE> <DELIMITERD> <EOL> 
C <KEYPOINT_DESCRIPTOR>D soe ] 
{ <BLANK LINESD ] 


CKEYPOINT_CONSTANT_LINE> t= <KEYPOINT_CONSTANT> <SPC> = <SPC> 
<KEYPDINTLBASE> <SPC> £ <QFFSET> 1 <SPC> 


CKEYPOINTLCONSTANT> 222 <IDENTIFIERD 
<KEYPOINT_ BASED t2= <IDENTIFIERD 


<KEYPOINTLDESCRIPTORD 232 0 CKEYPOINT_DESCRIPTOR_LLIST> <SPC> £€ 2 ] 
<EOL> 


<KEYPOINT_DESCRIPTORLULIST> 
C <SPECIALLCASE_COQDE> 1 <SPC> 
C <SUBLIO_ FIELD> 3 <SPC> <KEYPOINTL LABEL> 
<SPC> £ <DATA ~FIELD> ] 


<SPECIAL_CASE_CODE> s3= M1LN1S1T 
(M = MTR» N = NOS» S = TASK SWITCHs AND T = TRAP) 


<SUBLIDLFIELD> t8= <SUBLIDILENGTH> »« <SUBLIDUMATCH> 
<SUBLID_LENGTH> stt= <FIELD_LENGTH> 
<FIELDLLENGTH> %8= 00252 CIN BITS) 
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DILOKEYPOINTS SS ee, 2. 
D1.e5 BNF KEYPOINT DESCRIPTION | 
<SUB_LIDLUMATCH> st3= <SMALL_LINTEGERD 
<SMALLLINTEGER> 232 0.4. 0-FFFFFFFFFFFFF(16) 
<KEYPDINTLLABEL> | 
<LABEL> 88= " <CHARACTER_STRING> ° 
<CHARACTERLSTRING> 38t= ANY VISIBLE CHARACTERS EXCEPT ° 
<DATALFIELD> s3= <DATA_LABEL> <SPC> € <DATALFIELD_DESCRIPTORD 1] 
<DATALLABEL> 232 <LABEL> 
<DATALFIELDLDESCRIPTORD> %8= <DATALFORMAT> C <DATALFIELD_LLENGTH> ] 


<DATALFORMAT>D t3# A1lHi1 7 
(A = ALPHANUMERICs H = HEX» I = INTEGER) 


<DATALFIELD_LENGTH> t3= <FIELD_LENGTH> 


(NOTES <SUBLIDULENGTH> + <DATALFIELD_LLENGTH> MUST BE <= 52 BITS ) 
(NOTE: GQPERATING SYSTEM <KEYPOINT_CLASS_ID> = ODsEsUsX2) 

(NOTE? <KEYPOINT_CLASS_ID> FOR ANY KEYPOINT USED FOR 

ADDITIONAL INFORMATION TO PREVIOUS KEYPOINTS 

MUST BE A SPACE) 

(NOTE A <DEFINITION_DECK> REMAINS IN EFFECT UNTIL 

SUPERCEEDED BY A DECK WHICH REDEFINES THE 

AREA TO WHICH IT PERTAINS) 
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